=h 2 本 书 配套 电子 课件 和 源 代码 
à 移动 平台 开发 书库 S Ren r$ 


Android 


从 入 门 到 精通 


机 械 工 业 出 版 社 


CHINA MACHINE PRESS 


移动 平台 开发 书库 


Android 网 络 开 发 从 人 门 到 精通 


Rabie 等 编著 


9 


机 械 工 业 出 版 社 


TE Android 系统 从 诞生 到 现在 


和 开发 的 简洁 性 ， 已 牢 牢 占据 智能 


E 的 短 短 几 年 时 间 里 ， 


局 凭借 操作 的 易 用 性 


手机 操作 系统 市 场 占有 率 榜首 的 位 置 。 而 


在 Android 应 用 开发 领域 中 ， 网 络 
内 容 之 一 。 本 书 全 部 内 容 分 为 四 篇 ， 


发 一 直 
共计 17 章 , fü 


是 贯穿 Android 知识 体系 的 核心 


序 渐进 地 讲解 了 Android 


网 络 开发 方面 的 知识 。 本 书 从 搭建 
了 Android 系统 概述 ，Android 网 络 
载 、 上 传 数据 ，Socket 数据 通信 ， 


发 环境 和 核心 村 
BRM 


移动 网 页 ， 开 发 蓝牙 应 用 程序 ， 开 发 Wi-Fi 
发 电子 邮件 应 用 程序 ，Android 


解 


匡 架 分 析 讲 起 ， 依 次 讲解 

ty Java 中 的 网 络 通信 基础 ， 下 
里 XML 数据 ，WebKit 浏览 网 页 ， 开 发 
o IHR, 


NEC 近 场 通信 技术 详 


用 程序 ， 开 发 Web 版 的 电话 本 管理 


交友 系统 等 高 级 知识 。 本 书 几乎 涵盖 了 Android 网 络 


dE 


HA BAA TR, (rg gie HH 
们 的 学 习 ， 也 特别 适合 初学 者 的 系统 学 习 。 


发 移动 


电网 络 应 用 实践 ， 开 发 移动 微 情 应 
微 信 系统 ， 


BAT BABA 


t ` 


二、 详细 ， 不 但 适合 应 用 开发 高 手 


发 中 的 所 有 主要 内 容 ， 


本 书 适合 Android 初学 者 、Android 爱好 者 、Android 网 络 开 发 人 员 和 移动 
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Android 是 一 款 于 2007 年 11 月 5 日 发 布 的 基于 Linux 平台 的 开源 手机 操作 系统 ， 该 平台 


操作 系统 、 中 间 件 、 


j 户 界面 和 应 用 软件 组 成 ， 是 首 个 专 为 移动 终端 而 打造 的 移动 软件 。 


根据 国际 数据 公司 UDC) 公布 的 统计 数据 ， 在 2014 年 第 一 季度 ，Android 系统 和 iOS 系统 
所 占 的 装机 量 已 达到 所 有 智能 手机 出 货 量 的 92.3%。 在 2014 年 头 三 个 月 ， 安 装 Android 系统 


的 智能 手机 数量 升 至 


地 占据 着 智能 手机 操作 系统 第 一 的 位 置 。 


市 场 需求 分 析 


1.821 亿 部 。 我 们 有 理由 相信 ， 在 未 来 一 段 时 间 内 ，Android 将 依旧 牢 牢 


较 高 的 市 场 占有 


率 造 就 了 更 多 开发 人 员 关注 这 款 操作 系统 ， 当 然 也 不 乏 很 多 初学 者 ， 所 


以 也 就 很 自然 地 成 就 


了 相关 书籍 的 畅销 。 但 是 在 市 面 中 已 有 的 书籍 中 ， 大 多 数 是 入 门 级 的 教 


材 ， 而 关于 Android 网 络 开发 领域 书籍 屈指 可 数 ，Android 网 络 开发 领域 的 专业 级 书籍 更 是 窒 


SEIL, 
只 有 更 加 专业 才 


能 造就 Android 开发 的 殿堂 级 高 手 ! 为 了 让 广大 初学 者 可 以 对 Android 


网 络 开发 有 一 个 更 加 

发 方面 的 知识 进行 了 

以 致 用 地 讲解 了 在 现 
本 书 的 内 容 


本 书 全 部 内 容 共 


深入 的 认识 ， 而 不 是 停留 在 入 门 级 而 止步 不 前 。 本 书 对 Android 网 络 开 
细致 的 分 析 ,“ 提 炼 ” 出 了 Android 系统 开发 的 本 质 ， 并 依 此 为 基础 ， 学 
实 中 开发 典型 网 络 项 目的 实现 流程 。 


分 为 4 篇 ， 共 计 17 章 ， 循 序 渐进 地 讲解 了 Android 网 络 应 用 开发 方面 的 


知识 。 本 书 从 搭建 开发 环境 和 核心 框架 分 析 讲 起 ， 依 次 讲解 了 Android 技术 概述 ，Android 技 
术 核 心 框架 分 析 ，Java 中 的 网 络 通信 基础 ，WebKit 浏览 网 页 ， 开 发 移动 网 页 ， 开 发 蓝牙 应 用 


程序 ， 开 发 Wi-Fi 应 用 程序 ，NFC 近 场 通信 技术 详解 ， 开 发 电子 邮件 应 用 程序 ，Android 网 络 


典型 应 用 实践 ， 开 发 
陌 陌 交友 系统 ， 下 载 


移动 微 博 应 用 程序 ， 开 发 Web 版 的 电话 本 管理 系统 ， 移 动 微 信 系 统 ， 仿 
、 上 传 数据 ，Socket 数据 通信 ， 处 理 XML 数据 等 高 级 知识 。 本 书 几乎 涵 


itt J Android 网 络 应 用 


发 中 的 所 有 主要 内 容 ， 并 且 全 书 内 容 言 简 意 赎 ， 讲 解 方法 通俗 易 懂 、 


详细 ， 不 但 适合 应 用 
本 书 的 版 本 


发 高 手 们 的 学 习 ， 也 特别 有 利于 初学 者 学 习 并 消化 。 


Android 系统 自 2008 年 9 月 发 布 第 一 个 版 本 1.1 UK, BRE 2015 年 10 月 发 布 的 最 新 版 
本 6.0， 一 共存 在 十 多 个 版 本 。 由 此 可 见 ，Android 系统 升级 频率 较 快 ， 一 年 之 中 至 少 有 两 个 


必 和 追求 最 新 的 版 本 ， 


新 版 本 诞生 。 但 是 如 果 过 于 追求 新 版 本 , 会 造成 力不从心 的 后 果 。 所 以 在 此 建议 广大 读者 :“ 不 


我 们 只 需 关注 最 流行 的 版 本 即 可 ” 据 官方 统计 ， 截 至 2015 年 10 A, d 


据 前 三 位 的 版 本 分 别 


是 Android 4.2，Android 4.4 和 Android 5.0。 
Ul 


2014 Œ 10 月 


版 本 于 2014 年 10 月 16 日 推出。 本 书 的 内 容 以 编者 撰 稿 时 的 最 新 版 本 Android 5.0 为 基础 ， 
并 且 兼 容 了 Android 4.4 及 其 以 前 的 版 本 ， 详 细 讲 解 了 Android 网 络 应 用 开发 的 相关 知识 。 


本 书 特色 


， 谷 歌 /O 大 会 在 旧金山 开幕 。 会 上 谷歌 发 布 了 Android 5.0 系统 ， 其 正式 


本 书 内 容 丰 富 、 细 致 、 全 面 。 我 们 的 目标 是 通过 本 书 ， 提 供 多 本 图 书 的 价值 ， 读 者 可 以 


根据 自己 的 需求 有 选择 地 阅读 。 在 内 容 的 编写 上 ， 本 书 具 有 以 下 特色 。 


(OD 结构 合理 
从 用 户 的 实际 需求 出 发 ， 科 学 安排 知识 结构 ， 内 容 由 浅 入 深 ， 叙 述 清楚 。 全 书 详细 地 讲 


解 了 和 Android 网 络 应 用 开发 有 关 的 知识 ， 内 容 循序 渐进 ， 由 浅 入 深 。 
(2) 遵循 “理论 介绍 一 演示 实例 一 综合 演练 ”这 一 主线 


为 了 使 广大 读者 彻底 弄 清楚 Android 网 络 应 用 开发 的 每 一 个 知识 点 ， 在 讲解 时 依次 剖析 
了 基本 理论 、 演 示 实 例 分 析 、 综 合 实战 演练 等 内 容 。 遵 循 了 从 理论 到 实践 这 一 学 习 过 程 ， 实 
现 了 实践 教学 这 一 目标 。 


(3) EE. 


dae 


E 


本 书 内 容 条 理 清晰 、 语 言 简洁 ， 可 以 帮助 读者 快速 掌握 每 个 知识 点 。 使 读者 既 可 以 按照 


本 书 编排 的 章节 顺序 进行 学 习 ， 也 可 以 根据 自己 的 需求 对 某 一 章节 进行 针对 性 的 学 习 。 


(4) 实用 性 强 
本 书 彻底 握 弃 枯燥 的 理论 和 简单 的 操作 ， 注 


重 实用 性 和 可 操作 性 ， 通 过 简洁 的 语言 和 细 


m 


BUNT, FRAN 


(5) 内 容 全 面 


解 了 各 个 知识 点 的 基本 知识 。 


本 书 是 市 面 上 内 容 较 全 面 的 一 本 Android 网 络 应 用 开发 书 ， 无 论 是 开发 环境 搭建 ， 还 是 


各 个 和 常用、 常见 的 网 络 系统 ， 在 本 书 中 都 有 讲述 。 


读者 对 象 


@ Android 编程 的 初学 者 。 

@ 大 中 专 院 校 的 教师 和 学 生 。 

@ Android 编程 爱好 者 。 
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致谢 


本 书 的 编写 人 员 有 代 林 峰 、 管 西京 、 周 秀 、 张 余 、 李 佐 彬 、 王 梦 、 王 书 鹏 、 唐 凯 、 关 立 


We. SRE. May. ME, BA. ëm, oz TEAS kr, Su. gd. Pl 
^e. EIk 3EUJ. GG, Ep, 20981. EAS SIE, MRA AR RR 


ASE, Fk aR, (EAR. Wüdsc ARETE, OB) ARAYE o 


IV 


编 者 


H x 


前 言 
第 一 篇 ”基础 知识 篇 

第 1# Android 系统 概述 eene nennen 1 
1.1 智能 手机 系统 介绍 ee casa 1 
LLI 何谓 智能 手机 1 
IERCH SET ES IE TER Ram 1 
1.2 Android 5.0 Där Dë eene 2 
1.3 Android HJEK JEI eee eene 3 
13.1 “优点 一 一 一 系 出 名 门人 3 
13.2 ”优点 二 强大 的 开发 团队 和 3 
1.3.3 ”优点 三 一 一 诱 人 的 奖励 机 制 eerreerrrreerrreeeerreeerrreserrresersreeersneenrsneenrrneennreeernneet 4 
KEEN UU —————————— 4 
1.4 搭建 Android DV FA FE AERIS Henn ene 4 
1.4.1 安装 Android SDK [KJ RZ BER eee 5 
IER 3» —————À 5 
1.4.3 ”获取 并 安装 Eclipse OT E 9 
1.4.4 Ze JUI) ———————— 12 
1.4.5 WE Android SDK Home ee 14 
ËTT 15 
L4. 创建 Android 虚拟 设备 (AVIDJ mme 16 
1.4.8 ”启动 AVD RAPA EM 19 
1.5 第 一 段 Android TF «nee 20 
1.5.1 新建 Android 工程 ee 21 
1.52 ”编写 代码 21 
IEN 22 
1.5.4 ”运行 项 目 ee 24 
第 2 章 Android 网 络 开 发 基础 ne dd cect déesse Svaeess 26 
2. Android SDK P HJ oCh rä, eee eene 26 
22 Android 工程 文件 结构 介绍 和 28 
FEINEN 29 
FEELEN 29 
2.23 定义 常量 的 文件 和 30 
23 Android 中 的 数据 存储 方式 和 31 
2.3.1 SharedPreferences 存储 站 32 


24 


2.5 


第 3 章 


3.1 


3.2 


女生 = 


SA SS 
4.1 
4.2 


43 
44 


4.5 
4.6 


4.7 
第 5 章 
5.1 


5.2 


VI 


232 文件 存储 NENNEN ee ove cc sie elas DP ENEE NENNEN EN 34 


2.3.3 SQLite 存储 E 35 
2.3.4 Content Provider 存储 … 42 
2.3.5 网 络 存储 ——————————— 45 
访问 操作 SD E (手机 中 的 存储 卡 ) rr E 48 
24.1 解决 思路 —————————— 49 
242 cw HE "—————————— 49 
TFN oe HEELS EE 57 
第 二 篇 ”核心 技术 篇 
Java 中 的 网 络 通信 基础 ——————————————À 58 
Java 中 的 网 络 包 «eee eee eene 58 
3.1.1 InetAddress 22 RE fe —— 58 
3.1.2 URLDecoder 类 和 URLEncoder 26 :«: eene eene 59 
3.13 URL Fil URLConnection mme nennen 59 
EE 64 
Android BR qe 66 
EENEG 67 
322 ”实战 演练 一 一 在 手机 屏幕 中 传递 HTTP S me eee 67 
"ER HERE oe tese dasipatcseiuine nn iren inii 73 
FAMA RHR HRE T —————— 73 
下 载 网 络 中 的 JSON 数据 eee eee ee eee ene nenne 75 
dD Oe BE 76 
422 远程 下 载 服务 器 中 的 JSON 数据 站 77 
TB BEAR Eu e —— 82 
Epp A oum tutu. ute tt EI I M DUE Sp 85 
441 多 线程 下 载 文件 的 过 程 RE 85 
442 1E Android REE SUE ZgBUF dle een enne nennen 85 
FE vOkaloc RI 3E HH MHHHHeHHHHHHHHHI 102 
GET ETE eee 106 
4.6.1 使 用 GET dm rin 106 
4.6.2 ”实战 演练 一 一 采用 GET 方法 向 服务 器 传递 数据 和 107 
POST Fr eee eee eene lii 
Socket 数据 通信 eee eee 117 
Socket 编程 初 刀 站 117 
Sri de EE 117 
|. 118 
5.1.3 F Socket H Java PJA eeetetteerertereteeeeeerereseseesereseseenenereseseenesereseseeseneseseeeenenes 118 
TCP Jp pE EHE —€L^(^( ^^^^^^^—^^—^—«^—«—«4«—«—«-«-—»—»—»—»——»———————— 119 


5.3 


5.4 


Parag = 


So SS 
6.1 


6.2 


6.3 


6.4 


6.5 
第 7 章 
74 


7.2 


5.2.1 使 用 SeryletSocKeEt 2D 120 
5.2.2 {BFA IRIS 120 
5.2.3 TOP ol Se REN ccc 123 
524 实现 非 阻塞 Socket SHAG inen enne nnne nnne nnne nnns 127 
UDP 编程 …… 于 nn 133 
5.3.1 ”使 用 DatagramSocket-immmmmmmememeneeeneneeneneneenenennennenennnnennennnnnnnnnnennnnne 133 
5.3.2 4E MulticastSocket en 138 
在 Android 中 使 用 Socket SC H Zär ef HH 141 
处 理 XML 数据 145 
XML 技术 基础 145 
6.1.1 XML RI RP —— — 145 
612 XML [iE «eene nnne nennen nennen nnne nnn nennen nennen 145 
6.1.3 获取 XML WRG LII 146 
使 用 SAX 解析 XML tdg HH HH HH HH 148 
62.1 SAX Dem «eene nennen nennen nennen nennen nennen nennen nennen 148 
622 ”基于 对 象 和 基于 事件 的 接口 Meme HH 149 
6.223 WARO <a RE ———— 150 
6.24 实战 演练 一 一 在 Android 系统 中 使 用 SAX 解析 XML Me 153 
使 用 DOM 解析 KML ——! 756 
6.3.1 DOM RD — 156 
OEVEBP ORBE IS 157 
6.3.3 ”实战 演练 一 一 在 Android 系统 中 使 用 DOM 解析 XML ifs emen 158 
PULL 解析 技术 eeeeeereereereerrerrerrerrerrereeteereereeteeeretretreteetentreteeeretenteeeteteeteeteeeeeeeeereeeeeeeet 161 
6.4.1 PULL 273-5: RE "——— 161 
6.4.0 ”实战 演练 一 一 在 Android 系统 中 使 用 PULL 解析 XML Aliment 161 

实战 演练 一 三 种 解析 方式 的 综合 演练 eet eret teeth 164 
WebKit 331) YE Pa) DESEE € ££! 174 
WebKit JEJEJ HH Ha: 174 
7.1.1 主要 类 174 
742 ”使 用 内 置 浏 览 器 打开 网 页 ee 175 
Android 5.0 中 的 WebVieWw Hee eee eene 178 
7.2.1 WebView 22 GER IR ——— 178 
7.22 WebView SAUPIRE 181 
7.23 WebViewProvider 接口 EE 183 
724 WebViewChromium 详解 186 
7.2.5 WebViewChromiumFactoryProvider 详解 187 
7.2.6 ”AwContents ESO ——————————— 190 
7.2.7 实现 Mixed Content 模式 ee 193 
7.2.8 引入 第 三 方 o RE ——— 194 


72.9 ”实战 演练 一 一 在 手机 屏幕 中 浏览 网 DI een mmm mmm mH 196 
第 三 篇 “技术 提高 人 


EZE ET EE 199 
8.1 "2 Ei Android 网 页 代 硒 «eee eene 199 
8.1.1 8 = VIRILE 199 

8.1.2 编号 CSS Bal —————— 200 

8.1.3 CODE QE 203 

82 Jj Android 中 的 网 页 添加 CSS FEN eme eee e eee 203 
8.2.1 编写 基本 的 样式 203 

8.2.2 Lb E € 206 

83 "D Android 网 页 添加 JavaScript AA ——— A 207 
8.3. jQuery 框架 介绍 和 207 

8.3.2 ”使 网 页 支持 动态 行为 站 209 

84 ”在 Android 网 页 中 使 用 Ajax 特效 211 
8.5 使 用 第 三 方 框架 实现 动画 效果 PN 217 
8&51 一 个 开源 框架 JQTouche 218 
PME S EA ————— 218 

Big "Sio Ba Ty eee RR HIER cosas cu Lotte eta daa e Ca acte Con ease C Ma m 226 
8.601 在 Android 网 页 中 使 用 Web Storage 226 
8.6.2 TE Android 网 页 中 使 用 Web SQL Database: 237 

第 9 章 PRF AEJ oeeeeeeeeeeeererrrrrerererererrererrtrirerererrrrererereretnenererererererererereees 240 
9.1 蓝牙 技术 基础 和 240 
91.1 蓝牙 技术 的 发 展 历程 和 240 
9.1. JEE WEZ WIR nme ene 240 

9.1.3. JEE E DI EE 24] 

9.1.4 MEFE VLL 和 242 

92 分析 Android AAP OU dée SEM HH HH HH 243 
93 Android 系统 的 低 功 耗 蓝 牙 协 议 杰 ee 244 
9.3.1 Android IER d RT REH ENEE 244 

9.3.2” 低 功 耗 蓝 牙 API 详解 eee e n e eee en en enne eene 245 

gA: MEESE E 275 
9.4.1 BluetoothSocket XII —————— 276 
942 BluetoothServerSocket 类 ee 276 

9.43  BluetoothAdapter 类 ee 277 

9.44 BluetoothClass.Service 类 ee 281 

9.4.5 BluetoothClass.Device.Major 类 281 

9.4.6 BluetoothClass.Device 类 282 

9.4.7 BluetoothClass JE —— 282 


VIII 


E a oe se ee as 283 


9.5.1 界面 布局 —————— 283 
9.5.2 CIE MurC IE 284 

9.53 ”和 指定 的 服务 器 建立 连接 ee 286 

DEZ NEE WEE 287 

9.55 建立 和 OBEX ARABS VBR AGT nnnm 290 

9.5.6 “实现 蓝牙 服务 器 端的 数据 处 理 mmm mH 293 

$810 € 开发 WiFi 应 用 程序 站 297 
10.1 ff Wi-Fi 系统 的 结构 M Hee e 297 
10.1.1 ET 297 

10.1.2 Wi-Fi EYRE oversee ———— 297 

10.2 ”常用 的 Wi-Fi BE m HH HH HH HH Henne 299 
10.2.1 WifiManger 接口 ee 299 

10.2.2 WifiService IR ——— 299 

10.2.3 WifiWatchdogService PEL] «emen 300 

10.2.4 ”实战 演练 一 一 在 Android 系统 中 控制 Wi-Fi 300 

8 11 € NEC 近 场 通信 技术 详解 站 309 
11.1 TAB E LEES ZES N E 309 
11.1.1 NEC RED sees 309 

11.1.2 NFC ob EE 309 

11.1.3 NEC FUR DÉI 310 

11.2. Dn lk KEEN mmm mmm 311 
WPABBA)DECZNUPIMI C —— 31] 

11.2.2 REID EZ NIU 311 

11.2.3 RFID RAJKE D 312 

11.2.4 RFID HERI EAE JEU emm eene ener 313 

11.3 Android 系统 中 的 NEC- eee eee eene 313 
11.3.1 分 析 Java RR ——— 314 

11.3.2 ”分 析 JNI LI ————— 330 

11.3.3 Aa IR ———Ó 335 

11.4 ZE Android 系统 中 开发 NFC App BJ R eem 335 

11.5 ”实战 演练 使 用 NEC 发 送 消息 mmm meme eee eee 338 

第 12 章 FERTH TEE 344 
12.1 Æ Android P JEXEWTEIBIJI omm HH mee 344 
12.1.1 JEn C RE NIMM 344 

12.1.2 ”使 用 SmsManager 收发 邮件 350 
IKEA UNE 358 
12.2.1 Nur 358 

12.2.2 ”编写 主 程序 文件 E ———— 360 


第 13 章 Android 网 络 暴 型 应 用 实践 SNE NEEN ENNEN EEN NEEN EEN NENNEN NEEN EEN NNN ENN EEN EEN NENNEN ENN EEN oie ies 365 


13.1 测试 网 络 下 载 速度 人 365 
13.2 ”通过 Hander 实现 异步 消息 处 理 eee meme e 369 
13.2.1 实现 HTTP 通信 和 XML 解析 的 演示 mme 370 
13.2.2 ”使 用 Handler 实现 异步 消息 处 理 esee eene eene enn nen nnne nennen 375 

13.3. SEEMS A EE Bag mmm 380 
KREBS T ————- 380 
13.3.2 M cs) E ————— 381 

13.44 判断 当前 网 络 中 GPRS 和 Wi-Fi DIER m M HH 394 
13.4.1. ConnectivityManager 类 和 NetworkInfo 38 «eee eee 394 
134.0. CHE Ki xis] 9] Ze pst T A jg mmm 397 

13.5 启 或 关闭 APIN 398 
LONE Nei m oup AAS: bal see A SE M 402 
14.1 rb O 402 
[do ee A dose ei ee Nee Sas 403 
14.2.1 XML-RPC $x SIDE ——— 403 
14.22. Meta Weblog EE 405 

14.3 分析 腾讯 Android 版 微 博 API PP 405 
14.3.1 ELSE TEE 405 
14.3.2 BARE ERE "——— 406 

14.4 PEAR Android 版 新 浪 微 博 HH meme 410 
14.4.1 PRK He | E t SIBI] nmm 412 
VV PEE SIE SETTE) 1 DERE 418 
14.4.5. T ISON 对 象 获取 登录 新 浪 徽 博 nennen eene enn enn nnns 423 
14.4.4 SCH OAuth NE 425 
14.4.5 RAPPRE RE "———— 427 
14.4.6 2039 TS —————————— 429 
14.4.7 KIKRE Ri 431 
ËTT 432 
8815 € FÈ Web 版 的 电话 本 管理 系统 eem eee ee eee 438 
1$.1 IEEE 438 
15.1.1 L1: ——————— 438 
LAMB VII ——Ó——————— 438 

152 GIS Android 工程 mmm e eee eee eee 439 
1$.3 EU Side 1 IBI mem eee eene 440 
15.4 EER APE Eee eene 442 
15.5 SKE FASE EP E 444 
15.6 EN Die Ju E, eessen 448 
15.7 ÆR Bot RE, eee enne 451 


15.8 EE a eee eee eet 453 


ERIC EE mme eene 455 
I GNE qa 455 
16.1.1 (1 JT tm 455 
16.1.2 GUAR AI Q 信 的 美 系 和 455 

16.2 ”使 用 Android MOT 456 
16.3 VM uL ———€AA€(^^^^^^^^—^—«——€ 462 
IK ABBECLILM € 462 
16.3.2 ”系统 导航 界面 463 
16.3.3 DIU SL —————( 472 
163.4. "EI EAE eee nennen nennen 477 
IKRER E PD M ———Ó— € 481 

第 四 篇 ”综合 实战 篇 

第 17 章 ER EE 490 
17.1 SS bps 和 490 
17.1.1 Depp beleen 490 
17.1.2 rel rer 490 

17.2 EN Se ir FR Bp meme een eene 49] 
17.2.1 欢迎 界面 布局 492 
17.22. TEE 495 

17.3 ”实现 系统 注册 界面 和 497 
17.3.1 OT ng EE 498 
17.3.2 ”注册 界面 Activity 500 
KEES EE 506 
IER WEE 509 
1735 ”设置 用 户 名 界面 Activity: 512 
173.6 ”设置 生日 界面 Activity mme 514 
17.3.7 ”设置 头像 界面 Activity mmm 516 

17.4 SKE Side 1 IBI mem eee ee eee 520 
VERMES LIEBE 521 
KÉEN TEE 522 
1743 ”实现 “附近 的 人 ”界面 eem e eee nn e e ee e eene 523 
17.4.4 ”实现 “附近 的 群 组 ”界面 e M e e e e 527 


XI 


第 一 篇 ”基础 知识 篇 
D LZ Android 系统 概述 


Android 是 一 球 用 于 移动 智能 设备 手机、 平板 电脑 等 的 操作 系统 ， 以 Linux 系统 作为 
内 核 架构 。 从 2011 年 开始 到 现在 ，Android 系统 一 直 占 据 全 球 智能 手机 市 场 占 有 率 第 一 的 宝 
座 。 在 本 章 的 内 容 中 ,将 简单 地 介绍 Android 的 发 展 历程 和 背景 ， 并 介绍 搭建 Android 网 络 应 
用 开发 环境 的 基本 知识 ， 为 读者 进行 本 书后 面 知 识 的 学 习 打 下 基础 。 


11 智能 手机 系统 介绍 


智能 手机 是 指 具 有 像 个 人 计算 机 那样 强大 的 功能 ， 拥 有 独立 的 操作 系统 ， 用 户 可 以 自行 
安装 应 用 软件 、 游 戏 等 第 三 方 提供 的 应 用 程序 ， 并 且 可 以 通过 移动 网 络 接 入 到 无 线 网 络 中 。 
在 本 节 的 内 容 中 ， 将 详细 讲解 智能 手机 的 基本 知识 。 


111 何谓 智能 手机 
一 般 来 说 ， 智 能 手机 必须 具备 如 下 的 功能 。 
(1) 操作 系统 必须 支持 新 应 用 的 安装 。 

(2) 芯片 拥有 高 速 处 理 的 能 
(3) 可 以 播放 各 种 音频 和 视频 文件 。 
(4) 具有 大 容量 存储 芯片 和 存储 扩展 能 


手机 的 主要 特点 ， 有 具体 说 明 如 下 。 
(D 具备 普通 手机 的 所 有 功能 ， 例 如 拨打 、 接 听 电 话 和 收发 短信 等 。 
(2) 是 一 个 开放 性 的 操作 系统 ， 可 以 安装 第 三 方 应 用 程序 ， 从 而 实现 功能 的 无 限 扩展 。 
(3) 具备 上 网 功能 ， 例 如 可 以 浏览 网 页 。 
(4) 具备 PDA 的 功能 , 例如 能 够 实现 个 人 信息 管理 、 日 程 记事 、 任 务 安排 、 多 媒体 应 用 、 
浏览 网 页 等 功能 。 
(5) 扩展 性 能 强 ， 可 以 根据 个 人 需要 扩展 手机 的 功 


112 ”当前 主流 的 智能 手机 操作 系统 

在 Android 系统 诞生 之 前 ， 在 市 面 中 已 经 存在 了 很 多 优秀 的 智能 手机 产品 ， 例 如 诺基亚 
中 常见 的 Symbian 系列 和 微软 的 Windows Mobile 系列 等 。 在 当今 市 面 中 主流 的 智能 手机 系统 
包括 Windows Phone, iOS 和 本 书 的 主角 Android. 

1. Windows Phone 

微软 公司 于 2010 年 10 月 11 日 正式 发 布 了 智能 手机 操作 系统 Windows Phone， 并 将 其 使 用 
接口 称 为 “Modem”。Windows Phone 是 微软 公司 的 一 球 杰 出 触 控 产品 , 它 将 微软 旗下 的 Xbox Live 


umb 
D 


Android MSF RIAA (2 €) 1B 


游戏 、Xbox Music 音乐 与 独特 的 视频 体验 集成 至 手机 中 。2011 年 2 月 ， 诺 基 亚 与 微软 达成 全 球 
战略 同盟 并 深度 合作 共同 研发 。2011 年 9 月 27 日 ， 微 软 发 布 Windows Phone 7.5. 2012 年 6 H 
21 日 ， 微 软 正 式 发 布 Windows Phone 8， 采 用 和 Windows 8 相同 的 Windows NT 内 核 。 

2014 年 4 月 ， 微 软 在 Build2014 开发 者 大 会 发 布 Windows Phone 8.1。 在 2014 年 6 Aft, 
Windows Phone 8 手机 部 分 用 户 将 能 收 到 Windows Phone 8.1 预览 版 更 新 。2015 年 7 A 30 H, 
微软 向 全 球 用 户 推送 Windows Phone 10。 

2. iOS 

iOS 作为 苹果 移动 设备 iPhone 和 iPad 的 操作 系统 ， 在 App Store 的 推动 之 下 ， 成 为 了 世界 上 
引领 潮流 的 操作 系统 之 一 。iOS 系统 原名 为 “iPhone OS", 直到 2010 年 6 月 7 日 WWDC 大 会 上 
AMAA “iOS”. iOS 的 用 户 界 面 的 概念 基础 是 能 够 使 用 多 点 触 控 直接 操作 。 控 制 方法 包括 滑 
动 、 轻 触 开关 及 按键 。 与 系统 交互 包括 滑动 (Swiping)、 轻 按 (Tapping)、 挤 压 〈Pinching， 通 常 
用 于 缩小 ) 及 反 向 挤 压 (Reverse Pinching， 通 常用 于 放大 )。 此 外 通过 其 自 带 的 加 速 器 ， 可 以 令 
其 旋转 设备 改变 其 y 轴 以 令 屏幕 改变 方向 ， 这 样 的 设计 令 iPhone 更 便于 使 用 。 

2015 年 10 月 ， 苹 果 公 司 推出 了 版 本 iOS 9. 

3. Android 

Android 系统 于 2007 年 11 H 5 日 发 布 ， 该 平台 由 操作 系统 、 中 间 件 、 用 户 界 面 和 应 用 软 
件 组 成 ， 号 称 是 首 个 为 移动 终端 打造 的 真正 开放 和 完整 的 移动 软件 。 

根据 国际 数据 公司 (IDC) 2015 年 2 月 公布 的 新 数据 ， 在 2014 全 年 第 一 季度 ，Android 
和 iOS 系统 的 装机 量 占 到 所 有 智能 手机 出 货 量 的 96.396 。 其 中 , Android 出 货 量 为 10.59 亿 部 ， 
同比 增长 32%， 市 场 份 额 为 81.5%， 去 年 同期 为 78.7%; iPhone 出 货 量 为 1.927 亿 部 ， 同 比 去 
年 增长 23.6%， 市 场 份额 为 14.8%， 去 年 同期 为 15.1%。 

截止 到 本 书 完稿 时 ，Android 系统 的 最 新 版 本 是 Android 6.0， 市 面 中 最 主流 的 系统 是 
Android 5.0. 


12 Android 5.0 的 新 功能 


美国 太平 洋 时 间 2014 年 10 月 15 日 0 时 , 谷歌 (Google) 发 布 了 Android 5.0 (Lollipop), 
如 图 1-1 所 示 。 


图 1-1 Google 发 布 的 Android 5.0 


2 NH 
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2014 年 11 H3 H, Android 5.0 Lollipop CHRD 面向 用 户 正式 推出 。 开 发 者 已 经 可 以 
下 载 Android 5.0 Platform (API Level 21) 来 开发 和 测试 Android 5.0 应 用 ， 并 能 向 Google Play 


KA Android 5.0 专属 的 应 用 程序 。 
和 传统 版 本 相 比 ，Android 5.0 
(1) 全 新 的 Material 界面 设计 


的 突出 特性 如 下 。 


Android 5.0 Lollipop 界面 设计 的 灵感 来 源 于 


表 化 的 设计 ， 换 名 话说 ， 它 的 设计 


自然 、 物 理学 以 及 基于 打印 效果 的 粗 体 、 图 
是 一 种 基于 高 品质 纸张 的 效果 一 一 扁平 、 易 于 操作 。 
(2) 打造 健全 的 Android 生态 系统 


Android 将 不 仅仅 是 一 球 智 能 手机 操作 系统 ， 而 是 将 成 为 一 球 健 全 的 系统 出 现在 所 有 的 电子 


(3) 全 新 设计 的 通知 系统 


屏幕 中 ， 例 如 出 现在 平板 电脑 上 、 笔 记 本 电脑 上 、 电 视 机 


Fs 汽车 Es 手表 BE 家 用 电器 上 等 。 


除了 界面 有 较 大 改变 之 外 ， 谷 歌 还 调整 了 通知 中 心 的 信息 展示 规则 一 一 最 重要 的 信息 将 
被 显示 出 来 ， 而 次 要 信息 则 会 被 隐藏 。 当 然 ， 如 果 需 要 查看 全 部 信息 ， 则 继续 向 下 滑动 即 可 。 


(4) 64 位 ART 编译 器 


从 Android 5.0 版 本 开始 ，Dalvik 编译 器 即将 “退休 ”系统 默认 的 运行 环境 是 最 新 的 、 


(5) 提升 了 电池 续航 能 力 


更 高 效 的 ART。 同 时 ， 采 用 了 ART 环境 后 ，Android 能 够 兼容 ARM、X86 和 MIPS 等 架构 。 


从 Android 5.0 版 本 开始 ， 在 Project Volta 中 加 入 了 新 的 工具 来 帮助 开发 者 更 容易 地 发 现 


不 会 被 触发 (在 电池 电量 不 多 的 时 


13 Android 的 巨大 优势 


并 找 出 应 用 程序 为 什么 ， 或 者 说 在 哪 


候 )。 


特别 耗 电 。 还 有 新 的 工具 来 帮助 开发 者 确定 某 些 进程 


为 什么 Android 系统 能 在 这 么 多 的 智能 系统 中 脱颖而出 ， 成 为 市 场 占 有 率 第 一 的 手机 操 


VERSE? 要 分 析 其 原因 ， 需 要 先 了 解 它 的 优势 ， 分 析 究 竟 是 哪些 优点 获得 了 广 商 和 消费 


KHER EATHAR, Hita 
1.31 优点 一 一 一 系 出 名 门 


讲解 Android 系统 自身 的 巨大 优势 。 


Android 系统 出 身 于 Linux， 是 一 款 开 源 的 手机 操作 系统 。 在 Android 系统 取得 巨大 成 功 
之 后 , 各 大 手机 联盟 纷纷 加 入 ,这 个 联盟 由 包括 中 国 移动 、 摩 托 罗 拉 、 高 通 、HTC M T-Mobile 


在 内 的 30 多 家 技术 和 无 线 应 用 的 信 


动产 业内 形成 了 一 个 开放 式 的 生态 
1.3.2 ”优点 二 一 一 强大 的 开发 


页 军 企 业 组 成 。 通 过 与 运营 商 、 设 备 制造 商 、 开 发 商 和 其 他 


有 关 各 方 结 成 深层 次 的 合作 伙伴 关系 ， 借 助 建立 标准 化 、 


系统 。 
团队 


放 式 的 移动 电话 软件 平台 ， 在 移 


Android 的 研发 队伍 阵容 强大 ， 包 括 Google、 摩 托 罗 拉 、HTC (宏达电 子 )、PHILIPS、 
T-Mobile, fyi. AIK, =A. LG 以 及 中 国 移动 在 内 的 
誉 盛名 的 企业 。 它 们 都 将 基于 该 平台 开发 手机 的 新 型 业务 ， 这 样 以 来 应 用 之 间 的 通用 性 和 互 


联 性 将 在 最 大 程度 上 得 到 保证 。 并 


34 家 企业 ， 这 都 是 在 手机 领域 中 享 


日 还 成 立 了 手机 开放 联盟 ， 联 盟 中 的 成 员 名 单 如 下 。 


EN 3 


Android 网 络 开发 从 入 门 到 精通 


1. 手机 制造 商 
宏 达 国 际 电子 (HTC) (Palm 等 多 款 智能 手机 的 代 工厂 )， 摩 托 罗拉 《美国 最 大 的 手机 制 


造 商 之 一 )， 韩 匡 


三 星 电子 〈 仅 次 于 伴 果 的 全 球 第 二 大 手机 制造 商 )， 韩 国 LG 电子 ， 中 国 移 


动 〈 全 球 最 大 的 移动 运营 商 之 一 )， 日 本 KDDI (2900 万 用 户 )， 日 本 NTT DoCoMo (5200 万 


用 户 )， 美 国 Sprint Nextel (美国 


要 的 移动 


p ems 
(德意志 


2. 半导体 公司 

Audience Corp〈 声 音 处 理 器 公司 )，Broadcom Corp“〈 无 线 半导体 主要 提供 商 )， 英 特 尔 
(Intel), Marvell Technology Group, Nvidia 〈 图 形 处 理 器 公司 )，SiRF (GPS 技术 提供 商 )， 
Synaptics〈 手 机 用 户 界面 技术 )， 德 州 仪器 〈Texas Instruments)， 高 通 (Qualcomm), $3 HP 
(Hewlett-Packard Development Company,L.P ) . 

3. 软件 公司 

Aplix, Ascender, eBay 的 Skype, Esmertec, Living Image, NMS Communications, Noser 


第 三 大 移动 运营 商 ，5400 万 用 户 )， 意 大 利 电信 【意大利 主 


运营 商 之 一 ,3400 万 用 户 ), 西班牙 Telef6nica 〈 在 欧洲 和 拉美 有 1.5 亿 用 户 ), T-Mobile 
志 电 信 旗 下 公司 ， 在 美国 和 欧洲 有 1.1 亿 用 户 )。 


Engineering AG, Nuance Communications, PacketVideo, SkyPop, Sonix Network, TAT-The 


Astonishing Tribe, Wind River Systems. 


1.3.3 ”优点 三 一 一 诱 人 的 奖励 机 制 


谷歌 为 了 提高 程序 员 的 开发 积极 性 ， 不 但 为 他 们 提供 了 一 流 的 硬件 设置 ， 一 流 的 软件 服 


a, MH 


的 软件 。 


们 学 习 的 动力 。 
为 了 能 让 Android 3 


还 提供 了 振奋 人 心 的 奖励 机 制 ， 例 如 为 了 吸引 更 多 的 用 户 使 用 Android 进行 开发 ， 
已 经 成 功 举办 了 奖金 为 1000 万 美元 的 开发 者 竞赛 。 鼓 励 开 发 人 员 开发 


创意 十 足 、 非 常 有 用 


Er 


AKG TTA A RRI AMEE D CRIP AACE, wu ELS Ain) SE m t Kb 


F 台 吸引 更 多 的 关注 ， 谷 歌 发 布 了 官方 Android 软件 下 载 商店 Android 


Market， 地 址 是 http://www.Android.com/market/， 人 允许 开发 人 员 将 应 用 程序 在 上 面 发 布 ， 也 允 


VF Android 用 户 随 意 下 载 获取 上 


己 喜 欢 的 程序 。 作 为 开发 者 ， 需 要 申请 开发 者 账号 ， 申 请 后 


才能 将 自己 的 程序 上 传 到 Android Market， 并 且 可 以 对 自己 的 软件 进行 定价 。 所 以 说 ， 只 要 你 
的 软件 程序 足够 吸引 人 ， 你 就 可 以 获得 很 好 的 金钱 回报 ， 从 而 达到 学 习 、 赚 钱 两 不 误 。 


13.4 优点 四 一 一 开源 


对 天 


F 发 人 员 和 手机 厂商 来 说 ， 


源 意 味 着 Android 是 完全 免费 使 用 的 。 因 为 源 代码 公开 


的 原因 ， 所 以 激发 了 世界 各 地 无 数 程 序 员 的 热情 。 于 是 很 多 手机 厂商 都 纷纷 采用 Android 作 


为 自己 产品 的 操作 系统 。 


因为 免费 ， 所 以 降低 了 成 本 ， 提 高 了 利润 。 而 对 于 开发 人 员 来 说 ， 


众多 厂商 采用 Android 系统 就 意味 着 人 才 需 求 大 ， 所 以 纷纷 加 入 到 Android 开发 大 军 中 来 。 


14 搭建 Android 应 用 开发 环境 


EJ 


FAC Android 应 用 程序 之 育 


1， 首先 要 搭建 一 个 对 应 的 开发 环境 。 而 在 搭建 开发 环境 前 ， 


需要 了 解 安装 开发 工具 所 需要 的 


4 U 


硬件 和 软件 配置 条 件 。 在 本 区 的 内 容 中 ， 将 详细 讲解 搭建 


$8 1$ Android FARE 


Android 应 用 开发 环境 的 基本 知识 。 
141 安装 Android SDK 的 系统 要 求 
在 搭建 之 前 ， 先 确定 Android 应 用 程序 开发 对 开发 环境 的 要 求 ， 具 体 如 表 1-1 所 示 。 
表 1-1 开发 系统 所 需 参数 


项 版 本 要 求 说 明 备 dk 
Windows XP 或 以 上 ， 或 
操作 系统 Vista Mac OS X 10.4.8 或 以 上 ， 根据 自己 的 计算 机 自行 选择 选择 自己 最 熟悉 的 操作 系统 
或 Linux Ubuntu Drapper 或 以 上 
软件 开发 包 Android SDK 选择 最 新 版 本 的 SDK A 截止 到 目前 ， 最 新 手机 版 本 是 
ndroid 6.0 
Eclipse3.3 (Europa) # 以 上 
IDE Eclipse IDE+ADT ADT(Android Development Tools) 开 选择 “for Java Developer” 
发 插件 
Java SE Development Kit 5 或 6 单独 的 JRE 是 不 可 以 的 ， 必 须 
其 他 JDK Apache Ant Linux 和 Mac 上 使 用 Apache Ant | 要 有 JDK， 不 兼容 GNU Java hi 
1.6.5+, Windows 上 使 用 1.7+ 版 本 Pei 


Android 工具 是 由 多 个 开发 包 组 成 的 ， 具 体 说 明 如 下 。 
O JDK: 可 以 到 网 址 http:/www.oracle.com/technetwork/java/javase/downloads/index.html 
下 载 。 
C] Eclipse+Android SDK: 可 以 到 Android 官方 网 址 http://developer.android.com FREE 
Eclipse 和 Android SDK 的 压缩 包 。 
口 对 应 的 开发 插件 ， 最 为 常用 的 是 Eclipse ADT 插件 。 
14.2 zx JDK 
JDK (Java Development Kit) 是 整个 Java 的 核心 ,包括 了 Java 运行 环境 、Java 工具 和 Java 
基础 的 类 库 。 在 安装 JDK 之 前 需要 先 获得 JDK， 获 得 IDK 的 操作 流程 如 下 。 


(1) 登录 Oracle 官方 网 站 ， 官 方 下 载 页 面 网 址 为 http://developers.sun.com/downloads/， 如 
图 1-2 Bros. 


F 


Overview | Downloads | Documentation || Community || Technologies || Training 


Java SE Downloads 


v 
= Java C9 NetBeans 
Java Platform (JDK) 8u25 JDK 8u25 & NetBeans 8.0.1 


[ Java Platform, Standard Edition 


Java SE 8u25 

This release includes important security fixes. Oracle strongly recommends that all Java SE 8 
users upgrade to this release. 

Learn more + 


* Installation Instructions JDK 
DOWNLOAD # 
* Release Notes 


* Oracle License 


* Java SE Products Server JRE 


。 Third Party Licenses 


* Certified System Configurations 


* Readme Files 


* JDK ReadMe JRE 
* JRE ReadMe 


图 1-2 Oracle 官方 下 载 页 面 
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Android 网 络 开 发 从 入 门 到 精通 


— CD 在 图 1-2 中 可 以 根据 个 人 需要 来 选择 需要 下 载 的 版 本 ， 下 载 界面 效果 如 图 1-3 
Bes. 


Java Platform, Standard Edition 


Java SE 7u1 JDK JRE 

This release includes many security fixes. Learn 
more » 

"What Java Do I Need?" You musthave acopy of | JDK7 Docs JRE 7 Docs 


the JRE (Java Runtime Environment) on your 


Ss lets T * Installation * Installation 
system to run Java applications and applets. To Instructions Instructions 
develop Java applications and applets, you need E BEEN 
the JDK (Java Development Kit), which includes * ReadMe * ReadMe 
the JRE. 

* ReleaseNotes * ReleaseNotes 

* Oracle License * Oracle License 

* Java SE * Java SE 
Products Products 

* Third Party * Third Party 
Licenses Licenses 


* Certified System * Certified System 
Configurations Configurations 


Kl1-3 JDK 下 载 页 面 效果 


(3) 在 图 1-2 中 单 击 IDK 下 方 的 Download 按钮 , 在 弹出 的 新 界面 中 选择 将 要 下 载 的 JDK 


版 本 ， 编 者 在 此 选择 的 是 Windows x86 版 本 ， 如 图 1-4 所 示 。 


(4) 下 载 完成 后 双击 下 载 的 “.exe” 文 件 开始 安装 ， 将 弹出 “安装 向 时 ”对 话 框 ， 在 此 单 


击 “ 下 一 步 ” 按 钮 ， 如 图 1-5 所 示 。 


Java SE Development Kit 7u1 i Java(TM) SE Development Kit 7 Update 1 
You must accept the Oracle Code License for Java SE to download this 
software. 


ORACLE 


a Accept License Agreement [ol Decline License Agreement 欢迎 使 用 Java(TM) SE Development Kit 7 Update 1 安装 向 导 


Product / File Description File Size Download 
nos = E B z TEES = az Java(TM) SE Development Kit 7 Update 1 安装 程序 正在 准备 安装 向 导 ， 安 装 向 导 将 
= a 引导 您 完成 程序 安装 过 程 。 请 稍 候 。 
Linux x64 77.91 MB * jdk-7u1-linux-x64.rpm 
Linux x64 90.57 MB jdk-7u1-linux-x64.tar.gz 
Solaris x86 15478 MB * jdk-7u1-solaris-i586 tar. Z 
Solaris x86 9475 MB * jdk-7u1-solaris-i586.tar.gz 
Solaris SPARC 157.81MB Š jdk-7u1-solaris-sparc.tarZ 
Solaris SPARC 9948 MB Š jdk-7u1-solaris-sparc tar.gz 
Solaris SPARC 64-bit 1627 MB  jdk-7u1-solaris-sparcv9 tar.Z 
Solaris SPARC 64-bit 12.37 MB Š jdk-7u1-solaris-sparcv9 tar.gz 
Solaris x64 14.68 MB $ jdk-7u1-solaris-x64.tarZ 
Solaris x64 9.38 MB * jdk-7u1-solaris-x64 tar.az 
Windows x86 79.46 MB 2 jdk-7u1-windows-i586.exe < 上 一 步 (B) FEM > | DNBC 
Windows x64 80.24 MB *jdk7ui-windowsx64exe | E ees 


图 1-4 选择 Windows x86 版 本 图 1-5 “安装 向 导 ” 对 话 术 
(6) 弹出 “ 安 闭 路径” 对话 框 ， 在 此 选择 文件 的 安装 路 径 ， 如 图 1-6 所 示 。 


IHI 


(7) 在 此 可 以 设置 JDK 的 安装 路 径 单 击 “ 更 改 ” 按 钮 可 以 自 定 义 设 置 要 安装 的 位 置 。 单 


击 “ 下 一 步 ” 按 钮 开始 在 安 闭路 径 解压 缩 下 载 的 文件 ， 如 图 1-7 所 示 。 


H 


(8) 完成 后 弹出 “目标 文件 夹 ” 对 话 框 ， 在 此 单 击 
的 位 置 ， 如 图 1-8 所 示 。 

(9) 单 击 “ 下 一 步 ” 按 钮 后 开始 正式 安装 ， 如 图 1-9 所 示 。 
6 HED 


“更 改 ” 按 钮 可 以 自 定义 设置 要 安装 


j- "2 
$15 Android 系统 概述 几 


jg Java(TM) SE Development Kit 7 Update 1 — HENES ji Java(TM) SE Development Kit T Update 1 — HEE Pies 


ORACLE í = = Java ORACLE 


请 从 下 面 的 列表 中 选择 要 实 装 的 可 选 功 能 。 安 装 完成 后 ， 您 可 以 使 用 "控制 面板 "中 的 ' 添 加 / 


序 ' 实 用 程序 来 更 鸣 您 选择 的 功能 状态 : 
功能 说 明 一 一 一 一 一 一 一 PITT TET LTTE EEL i 
包含 源 代码 的 小 程序 和 应 用 程 
示 和 样 例 。 演 示 程 序 和 
HORE 46 MB 的 硬盘 驱动 器 
空间 。 
安装 到 : 
C:\Program Files\Java\jdk1.7.0_01\ ERA)... 
e | 
图 1-6 “安装 路 径 ” 对 话 框 图 1-7 解压 缩 下 载 的 文件 
LEE is 
= Java’ ORACLE ORACLE 
安装 到 : 
E:\jre7\ 


3 Billion Devices Run Java 


ma | rem: | 
图 1-8 "His 3e" He 图 1-9 ”继续 安装 


(10) 完成 后 弹出 “完成 ” 对话 框 ， 单 击 “ 完 成 ”按钮 后 完成 整个 安装 过 程 ， 如 图 1-10 
所 示 。 


jg Java(TM) SE Development Kit 7 Update 1 ~ 


ORACLE 


Java(TM) SE Development Kit 7 Update 1 已 成 功 安装 


产品 注册 是 免费 的 ， 您 将 获得 如 下 增值 服务 : 
获得 新 版 本 、 修 补 程序 和 更 新 的 通知 服务 

* 获 得 有 关 Orade 开发 者 产品 、 服 务 和 培训 的 忧 惠 
= 获得 对 昔 期 版 本 和 文档 的 访问 权限 


当 您 单 击 "完成 "后 将 收集 产品 与 系统 信息 ， 同 时 显示 IDK 产品 注册 表单 。 如 果 您 
不 注册 ， 则 不 保存 以 上 信息 。 


有 关注 册 所 收集 的 数据 以 及 这 些 数据 的 管理 和 使 用 方式 的 更 多 信息 ， 请 参见 产品 
注册 信息 “页面 。 


产品 注册 信息 介 ) | 


图 1-10 “完成 安装 过 程 


完成 安装 后 可 以 检测 是 否 安装 成 功 ， 检 测 方法 是 依次 单 击 计算 机 中 的 “开始 ”一 “运行 ” 
SEN 7 


— Android 网 络 开 发 从 入 门 到 精通 u 
按钮， pum 输入 “cmd” 命 令 并 按 (Enter) 键 ， 在 打开 的 CMD 窗口 中 输入 命令 : 


java —version 


如 果 显 示 如 图 1-11 所 示 的 提示 信息 ， 则 说 明 安 装 成 功 。 


cx C: \WIEDOTS \system32\cmd. exe 


Microsoft Windows XP [版 本 5.1.26081 
«C» 版 权 所 有 1985-2001 Microsoft Corp. 


C:\Documents and Settings\Administrator>java -version 

java version "1.7.0 81" 

JavaKTM»? SE Runtime Environment (build 1.7.8 801—588» 

Java HotSpot¢TM> Client UM build 21.1-b@2. mixed mode, sharing? 


C:\Documents and Settings\Administrator> 


K| 1-11 CMD 窗口 


如 果 检 测 没 有 安装 成 功 ， 需 要 将 其 目录 的 绝对 路 径 添加 到 系统 的 PATH 中 。 具 体 做 法 
如 下 。 

(1) 右键 依次 单 击 “ 我 的 电脑 ”一 “属性 ”一 “高 级 ” 单 击 下面 的 “环境 变量 ” 在 下 
面 的 “系统 变量 ”处 选择 “新 建 ”在 变量 名 中 输入 JAVA_HOME, 变量 值 中 输入 刚才 的 目录 ， 
比如 设置 为 “C:\Program Files\Javaydk1.7.0_01” 如 图 1-12 所 示 。 


TEAN): [TAVA HOME | 
变量 值 OD: [C:\Program Files\Java\jdkl.7.0_01] 


Le | as | 


图 1-12 设置 系统 变量 


j 


(2) 再 次 新 建 一 个 变量 名 为 classpath， 其 变量 值 如 下 。 


S%JAVA_HOME%/lib/rt.jar;7%JAVA_HOME%/lib/tools.jar 


击 “ 确 定 ” 按 钮 找到 PATH 的 变量 ， 双 击 或 单 击 编辑 ， 在 变量 值 最 前 面 添加 如 下 值 。 


%JAVA_HOME%/bin; 


具体 如 图 1-13 所 示 。 


编辑 系统 变量 


变量 名 QD: [classpath 
3ERHB (D: [ib/rt. jar: JAVA HOMEN/Lib/ tools. jar 


Cal ew | 


图 1-13 编辑 系统 变量 


(D 再 依次 单 击 “开始 ”一 “运行 ”在 运行 框 中 输入 “cmd” 命 令 并 按 (Enter) f, 在 


打开 的 CMD 窗口 中 输入 java -version， d coe 14 所 示 的 安装 成 功 提示 。 
S EH 


— 
| 
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c* C: \WINDOFS\system32\cad. exe 
t Windows XP [版 本 5.1.26001 
月 1985-2081 Microsoft Corp. 


C:\Documents and Settings\Administrator>java -version 

java version "1.7.0 01" 

JavaCIM> SE Runtime Environment Cbuild 1.7.0 01—b88»5 

Java HotSpotXTM»? Client UM Xbuild 21.1-b@2. mixed mode. sharing? 


B| 1-14 CMD 窗口 


注意 : 上 述 变 量 设置 中 ， 是 按照 编者 本 人 的 安装 路 径 设置 的 ， 编 者 安装 的 JDK 的 路 径 是 
C:\Program Files\Java\jdk1.7.0_01. 


1.4.3 ”获取 并 安装 Eclipse 和 Android SDK 

在 安装 好 JDK 后 , 接 下 来 需要 安装 Eclipse 和 Android SDK。Eclipse 是 进行 Android 应 用 
程序 开发 的 一 个 集成 工具 ， 而 Android SDK 是 开发 Android 应 用 程序 所 必须 有 具备 的 框架 。 在 
Android 官方 公布 的 最 新 版 本 中 ， 已 经 将 Eclipse 和 Android SDK 这 两 个 工具 进行 了 集成 ， 一 
次 下 载 即 可 同时 获得 这 两 个 工具 。 获 取 并 安装 Eclipse 和 Android SDK 的 具体 步骤 如 下 。 

(1) 登录 Android 的 官方 网 站 http://developer.android.com/index.html, 4n 1-15 所 示 。 


LI Developers - Design Develop Distribute Q 


Android 5.0 Lollipop 


The Android 5.0 update adds a variety of 
new features for your apps, such as 
notifications on the lock screen, an all-new 
camera API, OpenGL ES 3.1, the new 
Material design interface, and much more. 


Learn More 


Android Studio 
Learn about the new features in the 
beta release of our new IDE. 


Creating Apps with 
Material Design 

Learn how to apply material design to 
your apps. 


Building Apps for 
Wearables 

Learn how to build notifications, send 
and sync data, and use voice actions. 


K|1-15 Android 的 官方 网 站 


(2) 单 击 网 页 中 的 Getthe SDK 链接 ， 如 图 1-16 所 示 。 


Get the SDK » Browse Samples > Watch Videos > Manage Your Apps » 


图 1-16 单 击 Get the SDK 链接 
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(3) 在 弹出 的 新 页 面 中 单 击 Download the SDK 按钮 ， 如 图 1-17 所 示 。 


- Developers ~ Design Develop Distribute 
Training API Guides Reference Tools Google Services 
Developer Tools | Getthe Android SDK a 
Download | 
| The Android SDK provides you the API libraries and 
Setting Up the ADT developer tools necessary to build, test, and debug 
Bundle apps for Android. 
Setting Up an a | 
Existing IDE If you're a new Android developer, we recommend you 
h , download the ADT Bundle to quickly start developing 
Android Studio apps. It includes the essential Android SDK 
Exploring the SDK components and a version of the Eclipse IDE with 
built-in ADT (Android Developer Tools) to streamline 
Download the NDK | your Android app development. 
Workflow With a single download, the ADT Bundle includes 
everything you need to begin developing apps: 
Scb oy parari eae 
* Eclipse + ADT plugin 
Tools Help * Android SDK Tools 


P 


图 1-17 单 击 Download the SDK 按钮 


(4) 在 弹出 的 Get the Android SDK 界面 中 勾 选 have read and agree with the above terms 


and conditions 前 面 的 复 选 枉 ， 然 后 在 下 面 的 单 选 按钮 中 选择 系统 的 位 数 。 例 如 编者 的 计算 机 


是 32 位 的 ， 所 以 勾 选 “32-bit” 前 面 的 单 选 按钮 ， 如 图 1-18 所 示 。 


D 


Developer Tools 
Download ^ 


Setting Up the ADT 
Bundle 


Setting Up an v 
Existing IDE 


Android Studio v 
Exploring the SDK 
Download the NDK 


Workflow E 


Support Library ~ 


Tools Help Y 
Revisions v 
Samples 

ADK v 


Get the Android SDK 


Before installing the Android SDK, you must agree to the following terms and conditions. 


1.2 Android” means the Android software stack for devices, as made available under the Android Open Source 
Project, which is located at the following URL: http://source.android.com/, as updated from time to time. 


1.3 "Google" means Google Inc., a Delaware corporation with principal place of business at 1600 Amphitheatre 
Parkway, Mountain View, CA 94043, United States. 


2. Accepting this License Agreement 


2.1 In order to use the SDK, you must first agree to this License Agreement. You may not use the SDK if you do not 
accept this License Agreement. 


2.2 By clicking to accept, you hereby agree to the terms of this License Agreement. 
2.3 You may not use the SDK and may not accept the License Agreement if you are a person barred from receiving 


the SDK under the laws of the United States or other countries including the country in which you are resident or 
from which you use the SDK. 


2.4 If you are agreeing to be bound by this License Agreement on behalf of your employer or other entity, you = 


区 I have read and agree with the above terms and conditions 


© 32-bit © 64-bit 


Download the SDK ADT Bundle for Windows 


图 1-18 Get the Android SDK D 


P 


(5) 单 击 图 1-18 中 的 ET 扩 钮 后 开始 下 载 工作 ， 下 载 的 目标 文件 是 一 个 


压缩 包 ， 如 图 1-19 所 示 。 
10 BES 


#1 Android Rete ` 


| Ze adt-bundle-windows-x86-20140624. zip 359. 85MB 


AF] GREE. Ban 例 私人 空间 D 自 定 义 
C:ATDDOYNLDADY HIF T5. o4GB vY © 
登录 FTP 服务 器 
下 载 完 成 后 自动 运行 
PARITA 
原始 地 址 线程 数 (1-10) 5 


SAT ET |7 


图 1-19 开始 下 载 目标 文件 压缩 包 


C6) 将 下 载 得 到 的 压缩 包 进 行 解压 ， 解 压 后 的 目录 结构 如 网 1-20 所 示 。 


eclipse 2014/10/14 8:51 XHK 
sdk 2014/10/18 16:28 文件 来 
国 SDK Manager. exe 


2014/T/3 3:24 应 用 程序 216 KB 


图 1-20 解压 后 的 目录 结构 
由 此 可 见 ，Android 官方 已 经 将 
的 eclipse.exe FY EA1T7] 


Eclipse 和 Android SDK 实现 了 集成 。 双 击 eclipse 目录 中 
F Eclipse， 界 面 效 果 如 图 1-21 所 示 。 


File Edit Refactor Source Navigate Search Project Run Window Help 
= 


PIMP SE ari ee 


LE DAL wer IR 


D Package Explo.. 232 | ^ O 


sick Access IK 


BE Outline 53 


tem 
as” 
ES activity and intent 


= A 
An outline is not available. 


ems @ 区 Declaration EB Console 53 B BB|r* BH - r$- 7" 8 
Android 
E 
ET f 
53M of 8SM Ü] Loading data for An... 4.3: (100%) 9 
Al 1-21 打开 Eclipse 后 的 界面 效果 
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(7) 打开 Android SDK 的 方法 有 两 种 ， 第 一 种 是 双击 下 载 目录 中 的 “SDK Manager.exe” 
文件 ， 第 二 种 在 是 Eclipse 工具 栏 中 单 击 图 图 标 。 打 开 后 的 效果 如 图 1-22 所 示 ， 此 时 会 发 现 
当前 Android SDK 的 最 新 版 本 是 AndroidL (API 21). 


4. Android SDK Manager 


Android SDK Tools | 23.0.5 fj Installed = 
of Android SDK Platforn-tools | | 20 Update available: rev. 21 ` 
[OÊ Android SDK Paild-tools | | Wot installed 
[D Android SIK hireteols | T Tastate 
^1 "Et installed 
i | | 18.0.3 (Fot installed 
-OÊ Android SDK Paild-tools | 102 [Not installed 
m! 


|f Android SDE Build-tools 

DS Android SDE Puild-tools 
[OÊ Android SDK Paild-teols | Not installed 
“Df Android SDF Suitd-toots à deeg 
-口头 Android SDK Build-tools 10.1 |) Mot installed 

né | T 

[OŚ Android SDK Build-tools | Ej Installed 

Dy Android 5.0 (API 21) o | [ | 
-回国 Documentation for Android SPE T Not installed 
Bei 


Mot installed 
Not installed 


SDE Platform | | [D Fot installed 
-回国 ARM FABI v7a System Image [7] fet Installed 
-回国 Intel x86 Atom 64 System Image — | | mt installed — 
-回转 Intel x85 Atom System Inage | | [Met installed 
DÉI Google APIs | | "Et installed 
-回国 Google APIs ARM DEI v7a System Image | [| fet installed 

WB Google APIs Intel x86 Atom 64 System Image | | mt installed 

国 Google APIs Intel x86 Atom System Image | "Er installed ` 
FAT) Sources for Android SDK | [| Wot installed 
Dj Android L (API 20, L preview) | 

US Documentation for Android ’L’ Preview SDK 1 fp Installed 


图 1-22. 打开 Android SDK 后 的 界面 效果 


14.4 安装 ADT 


Android 为 Eclipse 定制 了 一 个 专用 插件 ADT (Android Development Tools)， 此 插件 为 用 
户 提供 了 一 个 强大 的 开发 Android 应 用 程序 的 综合 环境 。ADT 扩展 了 Eclipse 的 功能 ， 可 以 让 
用 户 快速 地 建立 Android 项 目 , 创建 应 用 程序 界面 。 要 安装 Android Development Tools plug-in， 
需要 首先 打开 Eclipse IDE。 然 后 进行 如 下 操作 。 

(1) 打开 Eclipse 后 ， 依 次 单 击 菜单 栏 中 的 Help Install New Software... 选 项 ， 如 图 1-23 
所 示 。 


Install Hew Software 


图 1-23 ”添加 插件 
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(2) 在 弹出 的 对 话 框 中 单 击 Add 按钮 ， 如 图 1-24 所 示 。 


Available Software 


Select a site or enter the location of a site. 


图 1-24 添加 插件 


(3) 在 弹出 的 Add Site 对 话 框 中 分 别 输入 名 
字 和 地 址 ， 名 字 可 以 自己 命名 ， 例 如 “123” 但 
是 在 Location 中 必须 输入 插件 的 网 络 地 址 STI SRT 
http://dl-ssl.google.com/Android/eclipse/, W| 1-25 
所 示 。 Z 
(4) 单 击 OK 按钮 ， 此 时 在 Install 界面 将 
会 显示 系统 中 可 用 的 插件 ， 如 图 1-26 Bras. 


图 1-25 设置 地 址 


Check the items that you wish to install. 


Ei DI 77 Developer Tools 
23. 0. 0. 1245622 
23.0. 0. 1245622 
23. 0. 0. 1245622 
23.0. 0. 1245622 
23. 0. 0. 1245622 
23. 0. 0. 1245622 


图 1-26 可 用 插件 列表 
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(5) 选中 Android DDMS 和 Android Development Tools， 然 后 单 击 Next 按钮 打开 插件 安 
装 详情 界面 ， 如 图 1-27 所 示 。 


oid DDMS 23.0.0. 1245622 
oid Development Tools 23.0.0. 1245622 
oid Mierarchy Viewer 23.0.0. 1245622 
oid Native Development Tools 23.0.0. 1245622 


oid Traceview 23.0.0. 1245622 
Gi Tracer for OpenGL ES 23.0.0. 1245622 


图 1-27 插件 安装 详情 界 画 
(6) 单 击 Finish 按钮 ， 开 始 进行 安装 ， 安 装 进 度 对 话 框 如 图 1-28 所 示 。 


Install (Blocked: The user operati... for background work to complete. ) 


Fetching com. android. ide. eclipse. a... adt_0. 9. 9. v201009221407-60953. jar 


图 1-28 ”开始 安装 
注意 : 在 上 个 步骤 中 ， 可 能 会 发 生计 算 插件 占用 资源 的 情况 ， 安 装 过 程 会 有 点 慢 ， 完 成 
后 会 提示 重启 Eclipse 来 加 载 插件 ， 等 重启 后 就 可 以 使 用 了 。 不 同 版 本 的 Eclipse 安装 插件 的 
方法 和 步骤 是 不 同 的 ， 但 是 都 大 同 小 异 ， 读 者 可 以 根据 操作 提示 自行 解决 。 
14.5 i& Android SDK Home 


当 完 成 上 述 插件 的 安装 工作 后 ， 此 时 还 不 能 使 用 Eclipse 创建 Android 项 目 ， 还 需要 在 
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Eclipse 中 设置 Android SDK 的 主 目录 。 
(1) 打开 Eclipse， 在 菜单 中 依次 单 击 Windows 一 Preferences 项 ， 如 图 1-29 所 示 。 


图 1-29 单 击 Preferences 项 


(2) 在 弹出 的 界面 左 侧 可 以 看 到 Android 项 ， 选 中 Android 后 ， 在 右 侧 设置 Android SDK 
所 在 目录 SDK Location， 单 击 OK 按钮 完成 设置 ， 如 图 1-30 所 示 。 


图 1-30 设置 Android SDK 所 在 目录 


1.4.0 ”验证 开发 环境 

经 过 前 面 步骤 的 讲解 ， 一 个 基本 的 Android 开发 环境 可 以 说 是 搭建 完成 了 。 下 面 通过 新 
建 一 个 项 目 来 验证 当前 的 环境 是 否 可 以 正常 工作 。 

(1) 打开 Eclipse， 在 菜单 中 依次 选择 File 一 New 一 Project 项 ， 在 弹出 的 对 话 框 中 可 以 看 
到 Android 类 型 的 选项 ， 如 图 1-31 所 示 。 
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E New Project 


Select a wizard 


图 1-31 新 建 项 目 


(2) 在 图 1-31 中 选择 Android， 单 击 Next 按钮 后 打开 New Android Application 对 话 框 ， 
在 对 应 的 文本 框 中 输入 必要 的 信息 ， 如 图 1-32 所 示 。 

(3) 单 击 Finish 按钮 后 ，Eclipse 会 自动 完成 项 目的 创建 工作 , 最 后 会 看 到 如 图 1-33 所 示 
的 项 目 结构 。 


Hew Android Application 


New Android Application 


@ Enter an application name (shown in launcher) 


Po 
| 
B o 
ofits Light with gera 可 & 49 first 

HM Android 5.0 

BS sre 

i ER? first. a 

ës gen [Generated Java Files] 
Cw assets 
H-E bin 
ae res 


i.m project.properties 


FA] 


图 1-32. New Android Application 对 话 框 图 1-33 项 目 结构 


14.7 创建 Android 虚拟 设备 (MVD) 
程序 开发 需要 调试 ， 只 有 经 过 调试 之 后 才能 验证 我 们 的 程序 是 否 能 正确 运行 。 作 为 一 款 
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手机 操作 系统 ， 开 发 者 如 何 能 在 计算 机 平台 上 调试 Android 应 用 程序 呢 ? 谷歌 为 开发 者 提供 
了 模拟 器 。 模 拟 器 是 指 在 计算 机 上 模拟 Android 系统 ， 使 用 模拟 器 可 以 调试 并 运行 开发 的 
Android 应 用 程序 。 由 此 可 见 ， 开 发 人 员 不 需要 使 用 一 个 真实 的 Android 手机 ， 而 是 只 通过 计 
算 机 即 可 模拟 运行 一 个 手机 环境 ， 进 而 开发 手机 应 用 程序 。 

谷歌 提供 的 模拟 器 是 AVD， 其 全 称 为 Android 虚拟 设备 (Android Virtual Device, AVD), 
每 个 AVD 模拟 了 一 套 虚 拟 设备 来 运行 Android 平台 ， 这 个 平台 至 少 要 有 自己 的 内 核 、 系 统 图 像 
和 数据 分 区 ， 还 可 以 有 自己 的 SD 卡 和 用 户 数据 以 及 外 观 显示 等 。 创 建 AVD 的 基本 步骤 如 下 。 

(1) 单 击 Eclips 菜单 中 的 图 标量 ， 如 图 1-34 所 示 。 


a 

File Edit Refactor Navigate Search Project Run Window Help 

D: Ia CRASH RG EELER 
Kuick Access seo 

[£5 Project Explorer 器 eum =o 


as 
田 HelloWorld 


c 区 Declaration EB Console $2 Relat Heri. B 


EI 


4 jp 


sin of 6201 


图 1-34 Eclipse Dm 


(2) 在 弹出 的 Android Virtual Device (AVD) Manager 界面 的 左 侧 导 航 中 选择 Android 
Virtual Device 选项 ， 如 图 1-35 所 示 。 


Android Virtual Devices | Device Definitions | 


List of existing Android Virtual Devices located at C:\Users\guan\. android\avd 


C] e Android 4.4.2 442 18 Intel Atom (86) 


C first Android 5.0 5.0 21 Intel Atom (x86_64) 


Å A repairable Android Virtual Device. DC An Android Virtual Device that failed to load Click Details’ to see the error. 


图 1-35 Android Virtual Device (AVD) Manager 界面 
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在 Virtual Devices 列表 中 列 出 了 当前 已 经 安装 的 AVD 版 本 , 可 以 通过 右 侧 的 按钮 来 创建 、 
删除 或 修改 AVD。 主 要 按钮 的 具体 说 明 如 下 。 


o Ce |]: 创建 新 的 AVD， 单 击 此 按钮 可 在 弹出 的 界面 中 可 以 创建 一 个 新 AVD, 
如 图 1-36 所 示 。 

a L9]. 修改 已 经 存在 的 AVD. 

a EE |， 删除 已 经 存在 的 AVD。 

a 区 = 启动 一 个 AVD 模拟 器 。 


Create new Android Virtual Device (AVD) xj 
AVD Name: zt 
Device: 

Target: Finaroias0o-iILvl2l eI 
CPU/ABI: [Entel Atom 71 1— 2:277 
Keyboard: J Hardware keyboard present 


Skin: 


Front Camera: fore 品 
Back Canera: pe | 
Memory Options: RAM: fo ‘VM Heap: |64 


Internal Storage: | Eon 


SD Card: 


Emulation Options: 厂 Snapshot JM Use Host GPU 


[ Override the existing AVD with the same name 


ewa | 


图 1-36 ”新建 AVD 界面 

新 建 AVD 界面 中 ， 各 主要 项 说 明 如 下 。 

O AVD Name: 在 此 设置 将 要 创建 的 AVD 的 名 字 ， 可 以 以 英文 字符 命名 。 

O Target: 在 此 设置 将 要 创建 的 AVD 的 API 版本, 例如 Android 2.3, Android 2.3、Android 
4.0、Android 5.0 等 。 

口 Device: 在 此 设置 将 要 创建 的 AVD 的 屏幕 分 辩 率 大 小 。 

口 CPU/ABI: 用 于 设置 当前 机 器 的 CPU。 在 开发 Android SDK 低 版 本 应 用 程序 时 ， 使 用 
的 Android 模拟 器 模拟 的 是 ARM 的 体系 结构 ， 这 个 模拟 器 并 不 是 运行 在 X86 上 ， 
所 以 在 调试 程序 的 时 候 和 运行 很 慢 。 针 对 这 个 问题 ， Intel 推出 了 支持 X86 的 Android 
模拟 器 ， 这 将 大 大 提高 软件 启动 速度 和 程序 的 运行 速度 ， 将 允许 Android 模拟 器 能 够 
以 原始 速度 〈 真 机 运行 速度 ) 运行 在 使 用 Intel x86 处 理 器 的 计算 机 中 。 所 以 对 于 使 用 
Intel x86 计算 机 开发 Android 应 用 程序 的 开发 者 来 说 , 建议 在 CPU/ABI 中 选择 有 Intel 
标识 符 的 选项 。 

注意 : 可 以 在 CMD 中 创建 或 删除 AVD， 例 如 可 以 使 用 如 下 CMD 命令 创建 一 个 AVD. 


android create avd --name <your_avd_name> --target <targetID> 
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其 中 “your avd name” 是 需要 创建 的 AVD 的 名 字 ， 在 CMD 窗口 界面 中 如 图 1-37 


C:\Documents and Settings\Administrator>android create aud —-name mm —-target 2 
Android 1.5 is a basic Android platforn. 
Do you wish to create a custom hardware profile [no] 


K| 1-37 CMD 窗口 


148 Aa AVD 模拟 器 
在 调试 Android 应 用 程序 时 需要 启动 AVD 模拟 器 ,启动 AVD 模拟 器 的 基本 流程 如 下 。 
COD 选择 图 1-35 列表 中 名 为 “win” 的 AVD， 单 击 EEE 按钮 后 弹出 Launch Option 对 
话 框 ， 如 图 1-38 所 示 。 
(2) 单 击 Launch 按钮 后 将 会 运行 名 为 “win” 的 模拟 器 ,运行 界面 效果 如 图 1-39 所 示 。 


$5554-win BEE 
000 


Android ‘Aa © m^ aa 


Launch Options A 
Skin: 720x1280 ] () ; e 
Density: 320 


Saturday, June 28 


EAM 


Monitor dpi Ee [*] 


Scale default 


E Wipe user data 
[^ Launch from snapshot 


[^ Save to snapshot 


cae | 


Charging 


RI 1-38 Launch Options 对 话 框 图 1-39 Android L 模拟 器 运行 界面 
注意 : 技巧 一 一 快速 安装 SDK 的 方法 
Android SDK Manager 在 线 安 装 的 速度 非常 慢 , 而 且 有 时 容易 断 开 。 其 实 可 以 先 从 网 络 中 
寻找 到 SDK 资源 ， 用 迅雷 等 下 载 工具 下 载 后 ， 将 其 放 到 指定 目录 后 就 可 以 完成 安装 。 具 体 方 
法 是 先 下 载 android-sdk-windows， 然 后 在 android-sdk-windows 下 双击 setup.exe， 在 更 新 的 过 
程 中 会 发 现 安装 Android SDK 的 速度 是 IKbits， 此 时 打开 迅雷 ， 分 别 输入 下 面 的 地 址 : 
https://dl-ssl.google.com/android/repository/platform-tools r05-windows.zip 
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https://dl-ssl.google.com/android/repository/docs-3.1 r01-linux.zip 
https://dl-ssl.google.com/android/repository/android-2.2 r01-windows.zip 
https://dl-ssl.google.com/android/repository/android-2.3.3 r01-linux.zip 
https://dl-ssl.google.com/android/repository/android-2.1 r01-windows.zip 
https://dl-ssl.google.com/android/repository/samples-2.3.3 r01-linux.zip 
https://dl-ssl.google.com/android/repository/samples-2.2 r01-linux.zip 
https://dl-ssl.google.com/android/repository/samples-2.1 r01-linux.zip 
https://dl-ssl.google.com/android/repository/compatibility r02.zip 
https://dl-ssl.google.com/android/repository/tools r11-windows.zip 
https://dl-ssl.google.com/android/repository/google apis-10 r02.zip 
https://dl-ssl.google.com/android/repository/android-2.3.1 r01-linux.zip 
https://dl-ssl.google.com/android/repository/usb driver r04-windows.zip 
https://dl-ssl.google.com/android/repository/googleadmobadssdkandroid-4. 1.0.zip 
https://dl-ssl.google.com/android/repository/market licensing-r01.zip 
https://dl-ssl.google.com/android/repository/market billing r01.zip 
https://dl-ssl.google.com/android/repository/google apis-8 r02.zip 
https://dl-ssl.google.com/android/repository/google apis-7 r01.zip 
https://dl-ssl.google.com/android/repository/google apis-9 r02.zip 


可 以 继续 根据 自己 开发 要 求 选择 不 同 版 本 的 API。 

下 载 完 后 将 它们 复制 到 android-sdk-windows/Temp 目录 下 ， 然 后 再 运行 setup.exe， 勾 选 
需要 的 API 选项， 会 发 现 很 快 就 安装 好 了 。 记 得 把 原始 文件 保留 好 ， 因 为 放 在 temp 目录 下 的 
文件 安装 好 后 很 快 就 会 被 删除 。 


1.5 “第 一 段 Android 程序 


体 开 始 之 前 先 做 一 个 


本 实例 的 功能 是 在 手机 屏幕 中 显示 问候 语 “ 你 好 我 的 朋友 !”， 在 具 
简单 的 流程 规划 ， 如 图 1-40 所 示 。 


调试 项 目 


用 Eclipse 


图 1-40 “规划 流程 图 


题 H 的 源码 路 径 
实例 1-1 在 手机 屏幕 中 显示 问候 语 dam, Mirst 
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154 新 建 Android 工程 


(1) 在 Eclipse 中 依次 单 击 File 一 New 一 Project 新 建 一 个 工程 文件 ， 如 图 1-41 所 示 。 
(2) 选择 Android Project 项 ， 单 击 Next 按钮 。 

(3) 在 弹出 的 New Android Application 对 话 框 中 ， 设 置 工 程 信 息 ， 如 图 1-42 所 示 。 
在 图 1-42 所 示 的 界面 中 依次 设置 工程 名 字 、 包 名 字 、Activity 名 字 和 应 用 名 字 。 


DR Her Android Application 


New Android Application 
@ Enter an application name (shown in launcher) 


Application Name: Of 


Project Name: cl 
Package Name: cl 


Minimum Required SDK:O[API 8: Android 2.2 ro  zl 
Target SDK:O[API 21: Android 4X Levi zl 

Compile With:G[API 20: Android 4.4 Citkat Wer) wy 

Theme: [Holo Light with Dark Action Bs — zl 


4} fa} Le} be 


(2) E CNN NN © 


图 1-41 新 建 工 程 文件 


15.2 ”编写 代码 


现在 已 经 创建 了 一 个 名 为 “first” 的 工程 文件 ， 现 在 打开 文人 
的 如 下 代码 。 


F firstjava， 会 显示 自动 生成 


package first.a; 
import android.app.Activity; 
import android.os.Bundle; 
public class fist MM extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


} 


如 果 此 时 运行 程序 ， 将 不 会 显示 任何 内 容 。 此 时 可 以 对 上 述 代码 进行 稍微 的 修改 ， 让 程 
序 输出 “HelloWorld”。。 具体 代码 如 下 。 


package first.a; 
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import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TextView; 


public class fist MM extends Activity 1 

/** Called when the activity is first created. */ 

@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
TextView tv = new TextView(this); 
tv.setText(" 你 好 我 的 朋友 ! "); 
setContentView(tv); 


} 
经 过 上 述 代码 的 改写 后 ， 可 以 在 屏幕 中 输出 “你 好 我 的 朋友 !”。 
15.3 ”调试 
Android 调试 一 般 分 为 3 个 步骤 ， 分 别 
(1) 设置 断 点 


此 处 的 设置 断 点 和 Java 中 的 方法 一 样 ， 可 以 通过 双击 代码 左边 的 区 域 进行 断 点 设置 ， 如 
1-43 所 示 。 


设置 断 点 、Debug 调试 和 断 点 调试 。 


ai 


Le 


id first Manifest 


iy 1 package first.a; 
2®import android.app.Activity:[] 


6 public class first extends Activity { 
/** Called when the activity is first created. */ 
89 GOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 
TextView tv = new TextView (this); 
tv.setText ("你 好 我 的 朋友 ! "); 


setContentView (tv); 


图 1-43 设置 断 点 


为 了 调试 方便 ， 可 以 设置 显示 代码 的 行 数 。 只 需 在 代码 左 侧 的 空白 部 分 单 击 右键 ， 在 弹 
出 的 菜单 中 选择 Show Line Numbers 命令 ， 如 图 1-44 所 示 。 


22 EE 


(2) Debug 调试 


E 2 
$15 Android SEI ` 


图 1-44 显示 行 数 


Debug Android 调试 项 目的 方法 和 普通 Debug Java 调试 项 目的 方法 类 似 , 唯一 的 不 同 是 在 
选择 调试 项 目 时 选择 Android Application 命令 。 具体 方法 是 右键 单 击 项 目 名 , 在 弹出 的 菜单 中 
中 依次 选择 Debug As— Android Application 命令 ， 如 图 1-45 所 示 。 


(3) 断 点 调试 


1 Context 


TMM 4aMMort android.app.Activity;|j 


irst extends Activity { 
when the activity is first created. */ 


d onCreate (Bundle savedInstanceState) { 
onCreate (savedInstanceState) ; 
tentView(R.layout.main); 

ew tv = new TextView(this) ; 
Text ("你 好 我 的 朋友 ! ") ; 


tentView (tv); 


7:01 - first] Starting activity first.a.first 


图 1-45 Debug 调试 


可 以 进行 单 步调 试 ， 具 体 调 试 方法 和 调试 普通 Java 程序 的 方法 类 似 ， 调 试 界面 如 图 1-46 


所 示 。 
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EN Resource - 014/AndroidManifest. zal — 


eo BS E 


first.a 

ID fist. java 
BS gen [Generated Java Fil 
BÀ Android Private Librari 


Androidllani fest. xml 
B project. properties 


15.4 运行 项 目 


«manifest xmlns 
package="first.a” 

android: versionCode="1" 
android: versionName="1.0"> 


<uses-sdk 
androi 
android:targetSdkVersion-"L" 

Ié 
<application 
android: 
android: 
android: 


</in 


indroid-"http://schemas. android. com/apk/res/android" 


d :minSdkVersion-"L" 


allowBackup-"true" 
icon-"fdrawable/icon" 
label-"éstring/app name"; 


«activity android:name-".fist" 


android: label="@string/app_name"> 


<intent-filter> 


«action android:names"android.intent.action.MAIN" /> 
Xcategory android:name="android. intent. category. LAUNCHER" /> 
itent-filter> 


</activity> 


</application> 


[F] Androi dani fest. xml 


014] New emulator found: emulator-5554 

014] Waiting for HOME ('android.process.acore') to be launched... 
0614] HOME is up on device ‘emulator-5554" 

014] Uploading @14.apk onto device 'emulator-5554" 

014] Installing 014.apk... 

014] Success! 

014] Starting activity first.a.fist on device emulator-5554 


图 1-46 调试 界面 


将 上 述 代码 保存 后 就 可 运行 这 段 程序 了 ， 有 基体 过 程 如 下 。 


CD 右键 单 击 项 目 名 ， 在 弹出 的 菜单 中 依次 选择 Run As 一 Android Applicatio 


如 图 1-47 所 示 。 
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D) fist. java 23 


ackage first.a; 
import android.app.Activity; 


d. os, Bundle: 
A. widget .TextView; 


istMM extends Activity ( 


B when the activity is first created. */ | 


d onCreate(Bundle savedInstanceState) ( - 


onCreate (savedInstanceState); 
htentView(R. layout.main); 

ew tv = new TextView(this) ; 
Text ("HelloWorld"); 
htentView(tv):; 


38 - first]Starting activity first.a.fistMM 
242 - first]àctivityManager: Starting: Intent 


图 1-47 ”开始 调试 
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(2) 此 时 工程 开始 运行 ， 运 行 完成 后 在 屏幕 中 输出 “你 好 我 的 朋友 !” 这 段 文字 ， 如 
图 1-48 所 示 。 


Ores Perea 
pid il a pn pri m p m pes em 
Pm er pnma m mrs 
hé aca cc eal emia 
nt n m er n ca 


图 1-48 ”运行 结果 
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在 Android 开发 体系 中 ， 网 络 应 用 开发 是 十 分 重要 的 一 大 领域 。 而 网 络 应 用 开发 领域 涉 
及 的 知识 范围 比较 广泛 ， 其 中 主要 包括 网 页 开发 、 远 程 数据 通信 、 蓝 牙 通 信 、WiFi 应 用 、 浏 
览 嚣 开发、 流量 统计 和 邮件 处 理 等 知识 。 在 学 习 上 述 应 用 开发 知识 之 前 ， 读 者 需要 先 上 其 备 一 
些 基 础 性 的 知识 。 从 本 章 的 内 容 开 始 ， 将 简要 讲解 开发 Android 网 络 应 用 项 目的 基础 性 知识 。 


2] Android SDK 帮助 文档 介绍 


当 读 者 下 载 并 安装 Android SDK Ja, 会 在 安装 目录 中 看 到 一 些 安装 文件 。 对 开发 者 来 说 ， 
其 中 的 帮助 文档 有 着 十 分 重要 的 参考 作用 。 在 Android SDK 帮助 文档 中 ， 详 细 介 绍 了 各 个 
Android API 接口 的 语法 格式 和 继承 关系 ， 并 且 介 绍 了 各 个 接口 中 的 函数 和 有 具体 用 法 ， 这 些 内 
容 对 开发 者 来 说 十 分 重要 。 

安装 Android SDK 后 ， 其 安装 目录 的 结构 如 图 2-1 所 示 。 


(ph add-ons 2014/10/18 19:49 "PZ 
Jo build-tools 2014/10/18 11:17 文件 来 
di docs 2014/10/18 16:29 "PZ 
Jp extras 2014/7/16 23:06 文件 来 
Jo platforms 2014/10/18 9:09 XX 
d platform-tools 2014/10/18 8:33 文件 来 
à samples 2014/10/13 11:21 ”文件 夹 
Je sources 2014/10/18 9:10 文件 来 
A system-images 2014/10/18 11:33 Xe 
Je temp 2014/10/18 19:51 GZ 
li tools 2014/10/13 9:53 文件 来 


图 2-1 Android SDK 安装 后 的 目录 结构 


其 中 主要 目录 的 具体 说 明 如 下 。 

O add-ons: 里 面包 含 了 官方 提供 的 API 包 ， 例 如 常用 的 Google Map API (谷歌 地 
接口 )。 

口 docs: 里 面包 含 了 帮助 文档 和 说 明文 档 。 

口 platforms: 里 面包 含 了 针对 每 个 版 本 的 SDK 版 本 ， 提 供 了 和 其 对 应 的 API 包 以 及 一 
些 示 例文 件 ， 其 中 包含 了 各 个 版 本 的 Android， 如 图 2-2 所 示 。 其 中 “android-21” 包 

含 的 就 是 Android 5.0 的 SDK. 
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J android-10 2014/T/16 21:48 文件 来 
D androia-14 2014/10/13 9:58 文件 来 
J android-19 2014/10/13 10:11 XE 
D android-20 2014/6/24 8:17 wik 
1 android-21 2014/10/18 9:09 fk 
D android-L 2014/10/13 11:20 XK 


图 2-2 platforms 目录 项 


T temp: 里 面包 含 了 一 些 常用 的 文件 模板 。 

口 tools: 包含 了 一 些 通用 的 工具 文件 。 

C] usb driver: 包含 了 AMD64 和 X86 下 的 驱动 文件 。 

O SDK Setup.exe: Android 的 启动 文件 。 

打开 SDK 帮助 文档 的 方法 非常 简单 ， 可 以 使 用 浏览 器 打开 “docs” 目 录 下 的 文件 
index.html， 如 图 2-3 所 示 。 然 后 单 击 顶部 Developers 中 的 Training 链接 可 以 跳 转 到 一 个 新 页 
面 ， 这 个 网 页 就 是 SDK 帮助 文档 的 学 习 主 页 ， 界 面 效果 如 图 2-4 所 示 。 


C] Developers Design Develop Distribute Q 


Android 5.0 Lollipop 


The Android 5.0 update adds a variety of 
new features for your apps, such as 
notifications on the lock screen, an all-new 
camera API, OpenGL ES 3.1, the new 
Material design interface, and much more. 


Learn More 


I Building Apps for Creating Apps with Android Studio 
Wearables Material Design Learn about the new features in the 
Learn how to build notifications, send Learn how to apply material design to beta release of our new IDE. 
EX and sync data, and use voice actions. your apps. 


Kl 2-3 SDK 文档 主页 


在 图 2-4 所 示 的 页 面 中 ， 介 绍 了 Android 基本 概念 和 当前 常用 版 本 。 此 SDK 文件 对 于 初 
学 者 来 说 十 分 重要 ， 可 以 帮助 读者 解决 很 多 常见 的 问题 ， 是 一 个 很 好 的 学 习 文 档 和 帮助 文档 。 
在 图 2-4 所 示 页 面 中 ， 左 侧 是 目录 索引 链接 ， 单 击 某 个 链接 后 可 以 在 右 侧 界面 中 显示 对 应 的 
说 明 信 息 。 如 果 要 想 迅 速 的 理解 一 个 问题 或 知识 点 ， 可 以 在 搜索 对 话 框 中 通过 输入 关键 字 的 
方式 进行 快速 检索 。 另 外 ， 有 很 多 热心 的 程序 员 和 学 者 对 帮助 文档 进行 了 翻译 ， 读 者 可 以 从 
网 络 中 获取 免费 的 中 文 版 帮助 文档 。 


+ 
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i Developers Design Develop Distribute Q 
Training API Guides Reference Tools Google Services Samples 
Getting Started 


Building Your First App 
Adding the Action Bar 


Supporting Different 
Devices 


Managing the Activity 
Lifecycle 


Building a Dynamic Ul with ~ 


Fragments 
Saving Data 


Interacting with Other 
Apps 


Building Apps with 
Content Sharing 


Building Apps with 
Multimedia 


Building Apps with 
Graphics & Animation 


Getting Started 


Welcome to Training for Android developers. Here you'll find sets of lessons within classes that describe how to 
accomplish a specific task with code samples you can re-use in your app. Classes are organized into several 
groups you can see at the top-level of the left navigation. 


This first group, Getting Started, teaches you the bare essentials for Android app development. If you're a new 
Android app developer, you should complete each of these classes in order. 


Building Your First App 


After you've installed the Android SDK, 
start with this class to learn the basics 
about Android app development. 


Creating an Android Project 
Running Your Application 
Building a Simple User Interface 


Starting Another Activity 


Adding the Action Bar 


The action bar is one of the most 
important design elements you can 
implement for your app's activities. 


Setting Up the Action Bar 
Adding Action Buttons 


Stvlina the Actinn Rar 


图 2-4 学 习 界 面 


22 Android 工程 文件 结构 介绍 


材 ， 介 绍 Android 工程 文件 结构 的 基本 知识 。 
在 Eclipse 中 打开 实例 1-1 的 工程 文件 ， 其 目录 结构 如 
2-5 PAN. 


y 


图 


作为 一 个 基本 的 
O src 目录 : 项 
口 R.java 文件 : 


Android 应 用 程序 ， 其 工程 文件 主要 由 以 下 部 分 组 成 。 


目 源 文 件 都 保存 在 这 个 目录 里 面 。 
这 个 文件 是 Eclipse 自动 生成 的 ， 应 用 开发 者 不 需要 去 修改 里 边 的 内 容 。 


个 文件 里 边 ， 


口 Androidmanifest.xml: 相当 于 应 


口 Android Library: 这 个 是 应 用 运行 的 Android 库 。 

O assets 目录 : 里 面 主要 放置 多 媒体 等 一 些 文件 。 ties 

O res 目录 : 里 面 主要 放置 应 用 用 到 的 资源 文件 。 SE sre 

O drawable 目录 :主要 放置 应 用 用 到 的 图 片 资源 。 a eee 

O layout 目录 主要 放置 用 到 的 布局 文件 。 这 些 布局 。 OP een eene Jura ite) 
文件 都 是 XML 文件 。 -名 assets 

QO values HR: 主要 放置 字符 串 〈strings.xml)、 颜 色 E re 
Ccolors.xml), 22H (arrays.xml). | fap certs 


(& drawable-hdpi 
(E drawable-Ldpi 
i (& drawable-mdpi 
(& drawable-xhdpi 


] 的 配置 文件 。 在 这 
必须 声明 应 用 的 名 称 ， 应 用 所 用 到 的 


Activity. Service 以 及 Receiver 等 。 | E ric : 
在 接 下 来 的 内 容 中 , 将 以 本 书 第 1 章 中 的 实例 1-1 7928 日 包 values 
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= 回 strings. xml 
Cl AndroidManifest. xml 


project.properties 


图 2-5 Android 应 用 工程 文件 组 成 
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2.21 SC 目录 


与 一 般 的 Java 项 目 一 样 ,，“src” 目 录 下 保存 的 是 项 目 中 的 所 有 包 及 源 文件 (.java), “res” 
目录 下 包含 了 项 目 中 的 所 有 资源 ,例如 ,程序 图 标 (drawable)、 布 局 文件 (layout) 和 常量 (values) 
等 。 不 同 的 是 ， 在 Java 项 目 中 没有 “gen” 目 录 ， 也 没有 每 个 Android 项 目 都 必须 有 的 
AndroidManfest.xml 文件 。 

“java” 格 式 文件 是 在 建立 项 目 时 自动 生成 的 ， 这 个 文件 是 只 读 模 式 ， 不 能 更 改 。 文 件 
Rjava 是 定义 该 项 目 所 有 资源 的 索引 文件 。 先 来 看 看 实例 1-1 项 目 中 的 文件 Rjava， 例 如 下 面 
的 代码 。 


/* AUTO-GENERATED FILE. DO NOT MODIFY. 
* 
* This class was automatically generated by the 
* aapt tool from the resource data it found. It 
* should not be modified by hand. 
«i 
package first.a; 
public final class R { 
public static final class attr { 
} 
public static final class drawable { 
public static final int icon=0x7f020000; 
} 
public static final class layout { 
public static final int main=0x7f030000; 
} 
public static final class string { 
public static final int app_name=0x7f040001; 
public static final int hello=0x7f040000; 


} 


从 上 述 代码 中 可 以 看 到 定义 了 很 多 常量 , 并 且 会 发 现 这 些 常量 的 名 字 都 与 res 文件 夹 中 的 
文件 名 相同 ， 这 再 次 证 明了 “java” 文 件 中 所 存储 的 就 是 该 项 目 所 有 资源 的 索引 。 有 了 这 个 
文件 ， 在 程序 中 使 用 资源 将 变 得 更 加 方便 。 由 于 这 个 文件 不 能 被 手动 编辑 ， 所 以 当 我 们 在 项 
目 中 加 入 了 新 的 资源 时 ， 只 需要 刷新 一 下 该 项 目 ,“java” 文 件 会 自动 生成 所 有 资源 的 索引 。 


2.2.2 ”文件 AndroidManiest.xml 


在 文件 AndroidManfest.xml 中 包含 了 该 项 目 中 所 使 用 的 Activity. Service. Receiver, £i 
下 面 实例 1-1 项 目 中 的 AndroidManfest.xml 文件 。 


<?xml version="1.0" encoding="utf-8"?> 

«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="first.a" 
android:versionCode="2 1" 
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android:versionName="1.0"> 


<uses-sdk 


android:minSdk Version="21" 
android:targetSdk Version="21" /> 


«application android:icon="(@drawable/icon" android:label="@string/app_name"> 


«activity android:name-" first" 


android:label-"(gstring/app name" 
<intent-filter> 


«action android:name="android.intent.action. MAIN" /> 
«category android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 


</activity> 


</application> 


</manifest> 


在 上 述 代码 中 ，intent-filter 描述 了 Activity 启动 的 位 


置 和 时 间 。 每 当 一 个 Activity (或 者 


操作 系统 ) 执行 一 个 操作 时 , 将 创建 一 个 Intent 的 对 象 , 这 个 Intent 对 象 保 存 了 我 们 想 做 什么 、 
想 处 理 什 么 数据 以 及 数据 类 型 等 描述 性 信息 。 而 Android 则 会 和 每 个 application 所 暴露 的 


intent-filter 数据 进行 比较 ， 找 到 最 合适 的 Activity KAH 


(ES? 


表 2-1 AndroidManfest.xml 分 析 


调用 者 所 指定 的 数据 和 操作 。 下 面 我 
分 析 AndroidManfest.xml 文件 ， 如 表 2-1 Bp. 


参 数 说 明 
manifest 根 节 点 ， 描 述 了 package 中 所 有 的 内 容 
; 包含 命名 空间 的 声明 。xmilns:android=http://schemas.android.com/apk/res/android， 使 得 Android 中 各 种 标 
xmlns:android A : f 
准 属性 能 在 文件 中 使 用 ， 提 供 了 大 部 分 元 素 中 的 数据 
Package 声明 应 用 程序 包 
ec 包含 package 中 application 级 别 组 件 声明 的 根 节 点 。 此 元 素 也 可 包含 application 的 一 些 全 局 和 默认 的 属 
were 性 ， 如 标签 、icon、 主 题 、 必 要 的 权限 ， 等 等 。 一 个 manifest 能 包含 0 个 或 1 个 此 元 素 (不 能 大 于 1 个) 
android:icon 应 用 程序 图 标 
android:label 应 用 程序 名 字 
用 来 与 用 户 交 互 的 主要 工具 。Activity 是 用 户 打 开 一 个 应 用 程序 的 初始 页 面 ， 大 部 分 被 使 用 到 的 其 他 页 
面 也 由 不 同 的 Activity 所 实现 , 并 声明 在 另外 的 Activity 标记 中 。 注 意 , 每 一 个 Activity 必须 有 一 个 <activity> 
Activity 标记 对 应 ， 无 论 它 给 外 部 使 用 或 是 只 用 于 自己 的 package 中 。 如 果 一 个 Activity 没有 对 应 的 标记 ， 则 不 能 
运行 。 男 外 ,为 了 支持 运行 时 查找 Activity， 可 包含 一 个 或 多 个 <intent-filter> 元 素来 描述 Activity 所 支持 的 
操作 
android:name 应 用 程序 默认 启动 的 Activity 
intent-filter 声明 了 指定 的 一 组 组 件 支持 的 Intent 值 , 从 而 形成 了 Intent Filter. 除了 能 在 此 元 素 下 指定 不 同类 型 的 值 ， 
属性 也 能 放 在 这 里 来 描述 一 个 操作 所 需 的 唯一 的 标签 、Icon 和 其 他 信息 
action 组 件 支 持 的 Intent Action〈 界 面 动作 ) 
category 组 件 支持 的 Intent Category。 这 里 指定 了 应 用 程序 默认 启动 的 Activity 
uses-sdk 该 应 用 程序 所 使 用 的 SDK 版 本 相关 信号 
kt E A 
2.23 ”定义 音量 的 文件 
在 实例 1-1 中 ,文件 String.xml 的 代码 非常 简单 ， 只 定义 了 两 个 普通 的 字符 串 资 源 。 有 具体 
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实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 

<resources> 
«string name="hello">Hello World, fistWM!</string> 
«string name="app_name">first</string> 


</resources> 


接 下 来 我 们 来 分 析 HelloAndroid 项 目的 布局 文件 (layout)， 首 先 我 们 打开 文件 


res\layout\main.xml， 其 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:orientation="Vertical" 
android:layout width-"fill parent" 


android:layout height-"fill parent" 
> 

<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"(a)string/hello" 
[E 


</LinearLayout> 
在 上 述 代码 中 ， 有 以 下 几 个 布局 和 参数 。 
口 < LinearLayout></LinearLayout>: 线性 版 面 配 置 ， 
上 到 下 的 队列 排 成 的 。 


在 这 个 标签 中 ， 所 有 元 件 都 是 按 由 


口 android:orientation: 表示 这 个 项 目的 版 面 是 从 


个 屏幕 。 


个 屏幕 。 


上 到 下 垂直 地 排列 其 内 部 的 视图 。 
口 android:layout_width: 定义 当前 视图 在 屏幕 上 所 占 的 宽度 ，fill_parent 表示 填充 整 


口 android:layout_ height: 定义 当前 视图 在 屏幕 上 所 占 的 高 度 ，fill_parent 表示 填充 整 


口 wrap content: 随 着 文字 栏 位 的 不 同 而 改变 这 个 视图 的 宽度 或 高 度 。 

在 上 述 布局 代码 中 ， 使 用 TextView 来 配置 文本 标签 于 的 属 
android:layout width 表示 占 满 整个 屏幕 的 宽度 ， 属 性 android:layout_height 表示 可 以 根据 文 
来 改变 高 度 ， 而 属性 android:text 则 设置 了 这 个 TextView 要 显示 的 文字 内 容 。 在 此 处 引用 了 


Widget〈 构 件 )， 其 中 设置 的 属性 


学 


@string 中 的 hello 字符 串 ， 即 文件 String.xml 中 的 hello 所 代表 的 字符 串 资源 。 


2.3 Android 中 的 数据 存储 方式 


Android 操作 系统 提供 的 是 一 种 公共 文件 系统 , 任何 应 用 软件 可 以 使 用 它 来 存储 和 读 取 文 


件 ， 该 文件 也 可 以 被 其 他 的 应 用 软件 所 读 取 (会 有 一 些 权 限 控制 设 定 )。 在 Android 系统 中 ， 


所 有 的 应 用 软件 数据 (包括 文件 ) 为 该 应 用 软件 所 私有 。 然 而 ，Android 同样 也 提供 了 一 种 标 
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准 方式 供应 用 软件 将 私有 数据 开放 给 其 他 应 用 软件 所 使 用 。 
在 Android 系统 中 提供 了 如 下 5 种 存储 数据 的 方式 。 
(1) 文件 存储 。 
(2) SQLite 数据 库 方式 。 
(3) 内 容 提 供 器 (Content Provider). 
(4) SharedPreferences. 
(5) 网 络 。 


2.3.1 SharedPreierences 存储 


SharedPreferences 存储 方式 是 Android 提供 的 一 种 用 来 存储 简单 设置 信息 的 机 制 , 经 常用 
于 存储 常见 的 欢迎 语 、 登 录用 户 名 和 密码 等 信息 。SharedPreferences 使 用 “ 键 - 值 ” 对 的 方式 
进行 存储 ， 这 样 开发 人 员 可 以 很 方便 的 实现 数据 的 读 取 和 存 入 。 
通过 使 用 SharedPreferences 存储 方式 ， 可 以 保存 Android 平台 中 的 Long 长 整形 、Int 整 
形 、String 字符 串 型 数据 。 可 以 将 SharedPreferences 中 的 数据 分 为 多 种 权限 ， 最 常用 的 是 设置 
为 全 局 共享 访问 。 最 终 会 以 XML 方式 来 保存 数据 。 在 处 理 这 些 XML 数据 时 ，Dalvik 会 通过 
自 带 的 底层 的 本 地 XML Parser 进行 解析 ， 比 如 XMLpull 方式 ， 这 种 方式 会 节约 内 存 资 源 。 
在 两 个 Activity 之 间 ， 除 了 可 以 通过 Intent 来 传递 数据 外 ,还 可 以 用 SharedPreferences 共 
享 数据 的 方式 实现 数据 传递 。 使 用 SharedPreferences 的 方法 很 简单 ， 例 如 可 以 先 在 A 中 设置 
如 下 代码 。 


editor sharedata = getSharedPreferences("data", 0).edit(); 
sharedata.putString("item","getSharedPreferences"); 
sharedata.commit(); 


然后 在 B 中 编写 如 下 获取 设置 信息 的 代码 。 


SharedPreferences sharedata = getSharedPreferences("data", 0); 
String data = sharedata.getString("item", null); 
Log.v("cola","data="+data); 


最 后 可 以 通过 以 下 Java 代码 将 获取 的 存储 数据 显示 出 来 。 


<SPAN class=hilitel>SharedPreferences 

</SPAN> sharedata = getSharedPreferences("data", 0); 
String data = sharedata.getString("item", null); 
Log.v("cola","data="+data); 


使 用 SharedPreferences 的 基本 方法 , 基本 上 和 使 用 J2SEGjava.util.prefs.Preferences) 的 
方法 一 样 ， 最 终 目 的 是 用 一 种 简单 的 、 透 明 的 方式 保存 用 户 个 性 化 设置 的 字体 、 颜 色 等 
参数 信息 。 在 绝 大 多 数 应 用 程序 中 ， 都 会 提供 “设置 ”或 者 “首选 项 ”之 类 的 界面 ， 这 
些 设置 可 以 通过 Preferences 来 保存 。 开 发 者 不 需要 知道 信息 到 底 以 什么 形式 保存 的 ， 保 
存在 了 什么 地 方 。 

在 接 下 来 的 内 容 中 ， 将 通过 一 个 具体 实例 来 讲解 SharedPreferences 存储 数据 的 方法 。 
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ko 功 能 


源码 路 径 


实例 2-1 使 用 SharedPreferences 存储 数据 


daima\2\SharedP 


(1) 编写 文件 SharedPreferencesHelper.java， 主 要 代码 如 下 . 


public class SharedPreferencesHelper { 

SharedPreferences sp; 

SharedPreferences.Editor editor; 
Context context; 
public SharedPreferencesHelper(Context c,String name) { 
context = c; 
sp = context.getSharedPreferences(name, 0); 
editor = sp.edit(); 
} 
public void putValue(String key, String value) { 
editor = sp.edit(); 
editor.putString(key, value); 
editor.commit(); 
j 

public String getValue(String key) { 
return sp.getString(key, null); 


j 
(2) 编写 文件 SharedPreferencesUsage.java， 主 要 代码 如 下 。 


public class SharedPreferencesUsage extends Activity { 
public final static String COLUMN NAME ="name"; 
public final static String COLUMN MOBILE ="mobile"; 
SharedPreferencesHelper sp; 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
sp = new SharedPreferencesHelper(this, "contacts"); 
sp.putValu((COLUMN NAME, "我 爱 故乡 月 "); 
sp.putValue(COLUMN MOBILE, "150xxxxxxxx"); 


String name = sp.getValu(COLUMN NAME); 
String mobile = sp.getValu(COLUMN MOBILE); 


TextView tv = new TextView(this); 
tv.setText("NAME:"+ name + "n" + "MOBILE:" + mobile); 
setContentView(tv); 


} 
通过 上 述 代 码 ， 在 SharedPreferences 中 存储 了 “NAME” 和 


“MOBILE” 的 数据 。 因 为 
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上 述 代 码 中 


pa 


的 pack name 为 : 


ckage com.android.SharedPreferences; 


所 以 存放 数据 的 路 径 为 : 


data/data/com.android.SharedPreferences/share_prefs/contacts.xml 


其 中 文件 contacts.xml 的 内 容 如 下 。 


<?xml version='1.0' encoding='utf-8' standalone='yes' ?> 


<map> 


<s 


tring name="mobile">150xxxxxxxx</string> 


<string name="name" > RZ WF A</ string> 


</map> 


执行 后 的 效果 如 图 2-6 所 示 。 


SharedPreferences 


NAME: 我 爱 故乡 月 
MOBILE:150XXXXXXXX 


图 2-6 执行 效果 


2.3.2 文件 存储 


虽然 使 用 SharedPreferences 存储 方式 的 方法 非常 方便 ， 但 是 这 种 方式 的 缺点 也 非常 明显 
一 一 只 适合 存储 比较 简单 的 数据 。 如 果 想 在 Android 系统 中 存储 更 多 的 数据 ， 有 多 种 方法 可 
供 我 们 选择 ， 例 如 本 小 节 将 要 讲解 的 文件 存储 方式 就 是 一 种 很 好 的 选择 。 和 传统 的 在 Java 中 


TI 


实现 VO 的 程序 类 似 ， 在 Android 中 ， 可 以 使 用 方法 openFileInput0 和 方法 openFileOutput()?K 
读 取 设备 上 的 文件 ， 例 如 下 面 的 代码 。 


String FILE NAME = "tempfile.tmp"; 


在 上 述 


/初始 化 
FileOutputStream fos = openFileOutput(FILE NAME, Context. MODE PRIVATE); 
FileInputStream fis = openFileInput(FILE NAME); 


尺码 中 ， 方 法 openFileInput0 和 方法 openFileOutputO 只 能 读 取 该 应 用 目录 下 的 文件 ， 


如 果 读 取 非 


其 目录 下 的 文件 则 会 抛 出 异常 。 如 果 在 调用 FileOutputStream 时 指定 的 文件 不 存在 ， 


Android 会 


动 创 建 它 。 并 且 在 默认 情况 下 ， 在 写 入 的 时 候 会 覆盖 原来 文件 的 内 容 。 如 果 想 把 新 


写 入 的 内 容 


附加 到 原文 件 内 容 之 后 ， 则 可 以 指定 其 模式 为 ContextMODE APPEND。 在 默认 情况 


下 ,使 用 方法 openFileOutput0 创 建 的 文件 只 能 被 其 调用 的 应 用 程序 使 用 ， 其 他 应 用 程序 无 法 读 取 
这 个 文件 。 如 果 需 要 在 不 同 的 应 用 中 共享 数据 ， 可 以 使 用 Content Provider 存储 方式 实现 。 
如 果 应 用 程序 需要 使 用 一 些 额外 的 资源 文件 ， 例 如 用 于 测试 音乐 播放 器 是 否 可 以 正常 工 


作 的 MP3 
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文件 ， 我 们 可 以 将 这 些 测试 文件 放 在 应 用 程序 的 /res/raw/ 目 录 下 ， 例 如 命名 为 


— 
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mydatafile.mp3 。 此 时 就 可 以 在 应 用 程序 中 使 用 geResources0 方 法 获取 资源 ， 然 后 用 
openRawResource() 方 法 〈 不 带 扩 展 名 的 资源 文件 名 ) 打开 这 个 文件 ， 具 体 实现 代码 如 下 。 


Resources myResources = getResources(); 
InputStream myFile = myResources.openRawResource(R.raw.myfilename); 


除了 使 用 方法 openFileImnput0 和 方法 openFileOutputO 读 写 文件 外 , 在 Android 中 还 可 以 使 
H deleteFile() 和 feList() 等 方法 来 操作 文件 。 


2.3.3 SQLite 存储 


fr Android 中 最 为 常用 的 存储 方式 是 SQLite Ze, GN EIE dg NUR. 
SQLite 是 Android 系统 自 带 的 一 个 标准 数据 库 ， 文 持 经 典 的 SQL i85). SQLite 遵守 ACID X 
联 式 数据 库 管 理 系统 ， 是 为 嵌入 式 系统 所 设计 的 产品 ， 并 且 目 前 已 经 在 很 多 和 藤 入 式 产品 中 使 
FA. SQLite 的 突出 优点 是 占用 非常 低 的 资源 。 在 仍 入 式 设备 中 ， 可 能 只 需要 几 百 KB 的 内 存 
即 可 。SQLite 能 够 支持 Windows. Linux, UNIX 等 主流 的 操作 系统 ， 同 时 能 够 跟 很 多 程序 语 
言 结合 使 用 , 例如 CH PHP 和 Java 等 。 并 且 还 支持 ODBC 接口 , 另外 和 MySQL、PostgreSQL 
这 两 款 开源 数据 库 管 理 系统 相 比 ，SQLite 的 处 理 速度 更 快 。 

注意 : ACID 是 指数 据 库 事务 正确 执行 的 四 个 基本 要 素 的 缩写 . LS: 原子 性 (Atomicity ). 
一 致 性 (Consistency )、 隔 离 性 (Isolation ). 4A (Durability) 一 个 支持 事务 (Transaction ) 
的 数据 库 系 统 ， 必 需要 具有 这 四 种 特性 ， 否 则 在 事务 过 程 (Transaction processing) 当中 无 法 
保证 数据 的 正确 性 ， 交 易 过 程 极 可 能 达 不 到 交易 方 的 要 求 。 

在 接 下 来 的 内 容 中 ， 将 通过 一 个 具体 实例 来 讲解 使 用 SQLite 存储 的 方法 。 


实 m 功 能 源码 路 径 
实例 2-2 练习 使 用 SQLite 来 存储 数据 daima\2\SQLite 


实例 文件 UserSQLite.java 的 具体 实现 流程 如 下 。 
(1) 定义 类 DatabaseHelper， 此 类 承 于 类 SQLiteOpenHelper， 具 体 代码 如 下 。 


private static class DatabaseHelper extends SQLiteOpenHelper { 
DatabaseHelper(Context context) { 
super(context, DATABASE NAME, null, DATABASE VERSION); 
} 
@Override 
public void onCreate(SQLiteDatabase db) { 
String sql = "CREATE TABLE "+ TABLE NAME +" ("+ TITLE 
+" text not null, " + BODY +" text not null " + ");"; 
Log.i("haiyang:createDB-", sql); 
db.execSQL (sql); 
} 
@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
} 
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在 上 述 代码 中 ， 首 先 分 别 习 


E f 7rik onCreate()fll onUpgrade(); 然后 在 方法 onCreate() 


中 构造 了 一 条 SQL 语句 ， 并 且 通 过 db.execSQL(sqD 执 行 了 这 条 SQL 语句 。 这 条 SQL 语句 的 
功能 是 生成 了 一 张 数 据 库 表 。 
类 SQLiteOpenHelper 是 一 个 辅助 类 ， 功 能 是 生成 一 个 数据 库 ， 并 对 数据 库 的 版 本 进行 管 


里 。 当 在 程序 当中 调用 这 个 类 的 方法 
当时 没有 数据 ， 那 么 Android 系统 就 会 


getWritableDatabase() 或 者 getReadableDatabase() 时 ， 如果 


自动 生成 一 个 数据 库 。 


类 SQLiteOpenHelper 是 一 个 抽象 类 ， 在 Android 应 用 项 目 中 通常 需要 继承 这 个 类 。 在 类 
SQLiteOpenHelper 的 实现 中 包含 了 如 下 3 个 方法 。 

口 方法 onCreate (SQLiteDatabase): 在 第 一 次 生成 数据 库 时 会 调用 这 个 方法 ， 一 般 我 们 

会 在 这 个 方法 中 生成 数据 库 表 。 

O 方法 onUpgrade (SQLiteDatabase, int, int): 当 数 据 库 需要 升级 的 时 候 ，Android 系统 


会 主动 的 调用 这 个 方法 。 


一 般 我 们 在 这 个 方法 中 删除 数据 表 ， 并 建立 新 的 数据 表 ， 当 


然 是 否 还 需要 做 其 他 的 操作 ， 完 全 取决 于 应 用 的 需求 。 
口 方法 onOpen (SQLiteDatabase): 这 是 当 打开 数据 库 时 的 回调 方法 ， 一 般 不 会 用 到 。 


(2) 编写 按钮 处 理 寻 


的 title 区 域 就 


如 果 单 击 “ 添 加 两 条 数据 ”按钮 ， 
程序 里 的 insertItem() 方 法 ， 具 体 代码 如 下 。 


FAAS 


private void insertItem() { 
/得 到 一 个 可 写 的 SQLite 数据 库 ， 如 果 这 个 数据 库 还 没有 建立 / 
/那么 mOpenHelper 辅助 类 负责 建立 这 个 数据 库 。/ 
/如 果 数 据 库 已 经 建立 ， 那 么 直接 返回 一 个 可 写 的 数据 库 。/ 
SQLiteDatabase db = mOpenHelper.getWritableDatabase(); 
String sqll = "insert into" + TABLE NAME +" ("+ TITLE +", "+ BODY 
+") values('AA', 'android 好 ");"; 


36 EB 


事件 ， 单 击 “ 捅 入 两 条 记录 ”按钮 后 ， 如 果 数 据 成 功 插入 到 数据 库 
的 diary 表 中 ， 那 么 在 界 国 


L 


会 显示 搬入 成 功 提 示人 信息， 如 图 2-7 所 示 。 


e ep ep o 
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R 2-7 插入 成 功 


会 执行 监听 器 里 的 onClick0 方 法 ， 并 最 终 执行 了 上 述 
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String sql2 = "insert into" +TABLE NAME +"("+TITLE+","+BODY 
+") values('BB’, 'android 好 ");"; 

try { 
Log.i("haiyang:sql1—", sql1); 
Log.i("haiyang:sql2-", sql2); 
db.execSQL(sql1); 
db.execSQL(sql2); 
setTitle(" 插 入 成 功 "); 

} catch (SQLException e) { 
setTitle(" 插 入 失败 "); 

} 

} 


在 上 述 代码 中 ，sqll 和 sql2 是 构造 的 两 条 标准 的 SQL 语句 ， 如 果 读 者 对 SQL 语句 不 是 
很 熟悉 ， 可 以 参考 相关 的 书籍 。 鉴 于 本 书 的 重点 是 Android， 所 以 对 SQL 语句 的 知识 不 进行 
详细 介绍 。 Log.i0 的 功能 是 将 参数 内 容 打印 到 日 志 中 , 并且 打印 级 别 是 Info 级 别 ; db.execSQL 
(sgll) 表示 执行 SQL 语句 。 

Android 支持 5 种 打印 输出 级 别 ， 分 别 是 Verbose、Debug、Info、Warning、Error， 在 应 
用 程序 中 最 常用 的 是 Info 级 别 ， 即 将 一 些 自己 需要 知道 的 信息 打印 出 来 ， 如 图 2-8 所 示 。 


H Problems | @ Javadoc [B Declaration f= Properties | [Z] Conso XN 
ndroi 


cx Bb | r^ EJ * T3 » — LH 


T TOOT ren F x 

[2010-02-19 15:50:15 - SQLite]Uploading SQLite.apk onto device 'emulator-5554' 
[2010-02-19 15:50:15 - SQLite]Installing SQLite.apk... 

[2010-02-19 15:50:31 - SQLite] Success! 


[2010-02-19 15:50:32 - SQLite]Starting activity com.eoeàAàndroid.SQLite.AàctivityMain on device 
[2010-02-19 15:50:39 - SQLite]àctivityManager: Starting: Intent ( comp-(com.eoeAndroid.SQLite/com.eoeàndroid.SQLite.Ac 


图 2-8 打印 输出 级 别 


(3) 单 击 “ 查 询 数据 库 ” 按 钮 ， 在 屏幕 界面 的 标题 (title) 区 域 会 显示 当前 数据 表 中 数据 
的 条 数 。 因 为 刚才 我 们 插入 了 两 条 数据 ， 所 以 现在 单 击 “查询 数据 库 ” 按 钮 后 会 显示 为 两 条 
记录 的 提示 ， 如 图 2-9 Bp. 
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图 2-9 查询 数据 
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的 方法 showItems()， 具 体 代 人 码 如 下 。 
必 在 屏幕 的 title 区 域 显示 当前 数据 表 当 中 的 数据 的 条 数 */ 


private void showltems() { 

/得 到 一 个 可 写 的 数据 库 / 

SQLiteDatabase db = mOpenHelper.getReadableDatabase(); 

String col[] = { TITLE, BODY }; 

Cursor cur = db.query(TABLE NAME, col, null, null, null, null, null); 
/通过 getCount0 方 法 ， 可 以 得 到 Cursor 当中 数据 的 个 数 。/ 
Integer num = cur.getCount(); 
setTitle(Integer.toString(num) +" wK"; 


j 


单 击 “查询 数据 库 ” 按 钮 后 会 执行 监听 器 里 的 onClick0) 方 法 ， 并 最 终 执行 了 上 述 程序 里 


在 上 述 代 码 中 , 语句 “Cursor cur = db.query(TABLE NAME, col, null, null, null, null, null)” 
的 功能 是 ， 将 查询 到 的 数据 放 到 一 个 Cursor 当中 。 在 这 个 Cursor 里 封装 了 数据 表 


TABLE NAME 中 的 所 有 条 列 。 
方法 query0 的 功能 是 查询 数据 ， 包 含 了 如 下 7 个 参数 。 


E 
NAME, JK "diary". 


定义 的 字符 串 会 代替 selection 中 的 “?”。 


分 组 。 
口 第 6 个 参数 : having， 相 当 于 SQL 语句 当中 的 having 部 分 。 


则 说 明 不 需要 排序 。 


第 1 个 参数 : 是 数据 库 中 表 的 名 字 ， 比 如 在 这 个 例子 中 ， 表 的 名 字 就 是 TABLE 


O 第 2 个 参数 : 是 我 们 想 要 返回 数据 包含 的 列 的 信息 。 在 这 个 例子 当中 我 们 想 要 得 到 的 
列 有 title、body， 我 们 把 这 两 个 列 的 名 字 放 到 字符 串 数 组 中 。 

O 第 3 个 参数 : selection， 相 当 于 SQL 语句 的 where 部 分 ， 如 果 想 返回 所 有 的 数据 ， 那 
么 就 直接 置 为 null。 

口 第 4 个 参数 : selectionArgs， 在 selection 部 分 有 可 能 用 到 “?” 那么 在 selectionArgs 


O 第 $ 个 参数 : groupBy， 定 义 查 询 出 来 的 数据 是 否 分 组 ， 如 果 为 null 则 说 明 不 用 


O 第 7 个 参数 : orderBy， 用 于 描述 我 们 期 望 的 返回 值 是 否 需 要 排序 ， 如 果 设 置 为 null 


注意 : Cursor 在 Android 当中 是 一 个 非常 有 用 的 接口 ， 通 过 Cursor 我 们 可 以 对 从 数据 库 


查询 出 来 的 结果 集 进行 随机 的 读 写 访问 。 


(4) 单 击 “删除 一 条 数据 ”按钮 后 ， 如 果 成 功 删 除 会 在 屏幕 的 title 区 域 看 到 文字 提示 ， 


如 图 2-10 所 示 。 


现在 再 次 单 击 “ 碍 询 数据 库 ” 按 钮 ， 会 发 现 数据 库 中 的 记录 少 了 一 


所 示 。 


条 ， 如 图 2-11 


当 单 击 “删除 一 条 数据 ” 按钮， 程序 会 执行 监听 器 中 的 onClick 方法 ， 


程序 里 的 deleteItem() 方 法 ， 其 实现 代码 如 下 。 
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x w! iW 6:42 


删除 了 一 条 title 为 AA 的 一 条 记录 


新 建 数据 表 
查询 数据 库 
添加 两 条 数据 


删除 一 条 数据 


删除 数据 表 


中 条 记录 
新 建 数据 表 


查询 数据 库 
添加 两 条 数据 
删除 一 条 数据 


删除 数据 表 


詹 删 除 其 中 的 一 条 数据 所 
private void deleteItem() { 
try { 


e ep ep e 


rescht 
(内 t 3 A 
waaw 


fafa Te fs fo fo fo 


mr 
i se a a 


图 2-10 删除 一 条 数据 


图 2-11 查询 数据 


SQLiteDatabase db = mOpenHelper.getWritableDatabase(); 
db.delete(TABLE NAME, " title ='AA"", null); 


setTitle(" 删 除了 一 


条 title 为 AA 的 一 条 记录 "); 


} catch (SQLException e) { 


} 


EN 39 


Android 网 络 开 发 从 入 门 到 精通 


在 上 述 代 码 中 ,通过 “db.delete(TABLE_NAME, " title = haiyang", null)” 语 句 删 除了 一 条 
tile 为 “AA” 的 数据 。 如 果 有 很 多 条 tite 为 “AA” 的 数据 ， 则 会 全 部 删除 。 方 法 delete0 中 
各 个 参数 的 具体 说 明 如 下 。 

口 第 1 个 参数 : 表示 数据 库 表 名 ， 在 这 里 是 TABLE NAME， 也 就 是 diary。 

口 第 2 个 参数 : 相当 于 SQL 语句 当中 的 where 部 分 ， 也 就 是 描述 了 删除 的 条 件 。 

如 果 在 第 2 个 参数 当中 有 “? ” 那么 第 3 个 参数 中 的 字符 串 会 依次 替换 在 第 2 个 参数 当 
中 出 现 的 “? ” 

(5) 单 击 “ 删 除数 据 表 ”按钮 后 可 以 删除 表 diary, An 2-12 所 示 。 


WE "drop table diary 


添加 两 条 数据 
删除 一 条 数据 


删除 数据 表 


teet 
Crema mee a 


图 2-12 删除 表 


FE 击 “删除 数据 表 ” 按 钮 后 会 执行 方法 dropTable0， 有 具体 代码 如 下 。 


PEIUS ARE 
private void dropTable() { 
SQLiteDatabase db = mOpenHelper.getWritableDatabase(); 
String sql = "drop table "+ TABLE NAME; 
try { 
db.execSQL(sql); 
setTitle(" 删 除 成 功 : "+ sql); 
} catch (SQLException e) { 
setTitle(" Ess v"); 


j 
j 


在 上 述 代 码 中 ， 构 造 了 一 个 标准 的 删除 数据 表 的 SQL 语句 ， 然 后 执行 语句 
db.execSQL(sql). 

(6) 此 时 如 果 单 击 其 他 按钮 可 能 会 出 现 运 行 异 常 ， 如 果 单 击 “ 新 建 数据 表 ” 按 钮 ， 执 行 
效果 如 图 2-13 所 示 。 
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图 2-13 JEK 
此 时 再 单 击 “查询 数据 库 ” 按 钮 可 以 查看 里 边 是 否 有 数据 存在 ， 如 图 2-14 所 示 。 


添加 两 条 数据 


Q200 


删除 数据 表 


fa a [a fs fof [a [a fo 
le fe lr lv luda lo 


s 
一 一 一 一 一 王广玉 
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图 2-14 显示 0 条 记录 


单 击 “ 新 建 数据 表 ” 按 钮 后 会 执行 方法 CreateTable0， 此 方法 的 功能 是 重新 建立 数据 表 。 
具体 代码 如 下 。 


* 重 新 建立 数据 表 */ 

private void CreateTable() { 

SQLiteDatabase db = mOpenHelper.getWritableDatabase(); 

String sql = "CREATE TABLE "+ TABLE NAME+"("+TITLE 
+" text not null, "+ BODY +" text not null " + ");"; 

Log.i("haiyang:createDB-", sql); 


> 
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try { 
db.execSQL("DROP TABLE IF EXISTS diary"); 
db.execSQL(sql); 
setTitle(" 重 建 数 据 表 成 功 "); 
} catch (SQLException e) { 
setTitle(" 重 建 数 据 表 错 误 "); 


j 
j 


在 上 述 代 码 中 ，sql 变量 表示 使 用 的 是 标准 的 SQL 语句 ， 功 能 是 按 要 求 建立 一 张 新 表 。 
“db.execSQL("DROP TABLE IF EXISTS diary” 表 示 如 果 存 在 表 diary 则 先 将 其 删除 ， 因 为 在 
同一 个 数据 库 中 不 能 出 现 两 张 同 名 字 的 表 ;“db.execSQL(sqD” 用 于 执行 SQL 语句 , 这 条 SQL 
语句 的 功能 是 建立 一 个 新 表 。 


2.3.4 Content Provider 存储 


TE Android 系统 中 的 数据 是 私有 的 ， 这 些 数据 包括 文件 数据 、 数 据 库 数据 和 一 些 其 他 类 
型 的 数据 。 在 Android 系统 中 的 两 个 程序 之 间 可 以 进行 数据 交换 ， 这 个 功能 是 通过 Content 
Provider 实现 的 。 

1. Content Provider 基础 

类 Content Provider 实现 了 一 组 标准 的 方法 接口 ， 从 而 能 够 让 其 他 的 应 用 保存 或 读 取 此 
Content Provider 的 各 种 数据 类 型 。 在 程序 中 可 以 通过 实现 Content Provider 抽象 接口 的 方式 将 
自己 的 数据 显示 出 来 ， 而 在 外 界 不 会 看 到 这 个 显示 数据 在 应 用 当中 是 如 何 存储 的 。 我 们 无 需 
关心 是 用 数据 库存 储 还 是 用 文件 存储 。 外 界 可 以 通过 这 套 标准 的 、 统 一 的 接口 在 程序 中 实现 
数据 交互 ， 即 可 以 读 取 程 序 里 的 数据 ， 也 可 以 删除 程序 里 的 数据 。 

在 现实 中 有 如 下 几 种 比较 常见 的 Content Provider 接口 。 

(1) ContentResolver 接 

外 部 程序 可 以 通过 ContentResolver 接口 访问 Content Provider 提供 的 数据 。 在 Activity 当 
中 ,可 以 通过 方法 getContentResolver0 获 取 当 前 应 用 的 ContentResolver 实例 。ContentResolver 
提供 的 接口 需要 和 Content Provider 中 需要 实现 的 接口 相对 应 。 接口 ContentResolver 中 的 常用 
方法 如 下 。 

Q query ( Uri uri, String[] projection, String selection, Small selectionArgs,String 
sortOrder): 通过 Uri 进行 查询 ， 返 回 一 个 Cursor. 

C] insert (Uri url, ContentValues values): 将 一 组 数据 插入 到 Uri 指定 的 地 方 。 

O update (Uri uri, ContentValues values, String where, String[] selectionArgs): 更 新 Uri 指 


定位 置 的 数据 。 
口 delete (Uri url, String where, String[] selectionArgs): 删除 指定 Uri 并 且 符 合 一 定 条 件 的 
数据 。 


(2) Content Provider 和 ContentResolver 中 的 URI 
在 Content Provider 和 ContentResolver 中 ， 通 常 有 两 种 使 用 URI 的 形式 ， 一 种 是 指定 所 
有 的 数据 ， 男 一 种 是 只 指定 某 个 DD 的 数据 。 例 如 下 面 的 代码 。 
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content://contacts/people/ // 此 URI 指定 的 就 是 全 部 的 联系 人 数据 
content://contacts/people/1 // 此 URI 指定 的 是 了 D 为 1 的 联系 人 的 数据 


在 上 边 用 到 的 URI 一 般 由 如 下 3 部 分 组 成 。 


此 有 


eli 


> 
kk 


部 分 是 “content://”。 


部 分 是 要 获得 数据 的 一 个 字符 串 片段 。 
分 是 ID 〈 如 果 没 有 指定 ID， 那么 表示 返回 全 部 )。 


tI 
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a 


> 
D 
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ng 
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因为 URI 通常 比较 长 ， 而 且 有 时 候 容 易 出 错 ， 并 且 难 以 理解 。 所 以 在 Android 中 定义 了 
甫 助 类 和 常量 来 代替 这 些 长 字符 串 的 使 用 ， 例 如 下 边 的 代码 。 


Contacts.People.CONTENT URI (联系 人 的 URI) 


2. 使 用 Content Provider 


为 了 使 读者 掌握 Content Provider 存储 的 用 法 ， 接 下 来 将 通过 一 个 具体 实例 的 实现 过 程 ， 


详细 讲解 在 Android 中 使 用 Content Provider 存储 数据 的 基本 流程 。 


实 mpl Xj 能 源码 路 径 


实例 2-3 使 用 SQLite 来 存储 数据 daima\2\ContentProviderP 


主 程序 文件 ActivityMain.java 的 具体 代码 如 下 。 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Cursor c = getContentResolver().query(Phones.CONTENT_URI, null, null, null, null); 
startManagingCursor(c); 
ListAdapter adapter = new SimpleCursorA dapter(this, 
android.R.layout.simple list item 2, c, 
new String[] ( Phones. NAME, Phones. NUMBER }, 
new int[] { android.R.id.textl, android. R.id.text2 1); 
setListA dapter(adapter); 
} 


对 上 述 代码 的 具体 说 明 如 下 。 
(1) 方法 getContentResolver(): 得 到 应 用 的 ContentResolver 实例 。 
(2) 方法 query (Phones.CONTENT URL null, null, null, null): 是 ContentResolver 中 的 方 


字 ， 它 指定 返回 数据 表 中 那些 列 的 值 。 


法 ， 用 于 查询 所 有 联系 人 ， 并 返回 一 个 Cursor。 此 方法 中 各 个 参数 的 具体 说 明 如 下 : 


第 1 个 参数 为 Uri， 在 此 例 中 的 URI 是 联系 人 的 URI。 
第 2 个 参数 是 一 个 字符 串 的 数组 , 数组 里 边 的 每 一 个 字符 串 都 是 数据 表 中 某 一 列 的 名 


第 3 个 参数 相当 于 SQL 语句 的 where 部 分 ， 描 述 哪些 值 是 我 们 需要 的 。 
第 4 个 参数 是 一 个 字符 串 数组 ， 里 边 的 值 依次 代替 在 第 三 个 参数 中 出 现 的 “?”。 
第 5 个 参数 指定 了 排序 的 方式 。 


(3) startManagingCursor(c) 语 句 : 让 系统 来 管理 生成 的 Cursor. 
(4) ListAdapter adapter = new SimpleCursorA dapter(this, Android.R.layout.simple_list_item_2, 


ut 


In 
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c, new String[] { Phones.NAME, Phones.NUMBER }, 
new int[] { Android.R.id.textl, Android.R.id.text2 !): 用 
于 生成 一 个 SimpleCursorAdapter. aoe 

(5 ) setListAdapter(adapter) : 将 ListView 和 
SimpleCursorAdapter 进行 绑 定 。 

运行 后 的 效果 如 图 2-15 所 示 。 

我 们 可 以 在 联系 人 列表 中 添加 几 条 数据 ， 有 具体 添加 流程 如 下 。 

(1) 单 击 模 拟 器 的 图 刍 ， 在 弹出 的 界面 中 单 击 Contacts 按钮 ， 如 图 2-16 所 示 。 


图 2-15 ”初始 效果 


Sam) € 3:11AM 
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Dialer Contacts Browser 


图 2-16 出现 的 桌面 


(2) 单 击 MENU 项 ， 在 弹出 界面 中 单 击 Creat new contact 选项 ， 如 图 2-17 所 示 。 


ed Raf] @ 3:20 am 


Choose a contact shortcut 


Create new contact 
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图 2-17 fut New contact 按钮 
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(3) 添加 联系 人 姓名 和 电话 号 码 信息 ， 如 图 2-18 所 示 。 


DN BM 43 3:20am 


New contact 
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Phone numbers (+) 


wen | Phone number 一， 


Email addresses (+) 
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图 2-18 ”添加 联系 人 姓名 和 电话 号 码 
(4) 单 击 Save 按钮 添加 新 建 的 联系 人 信息 ， 如 图 2-19 所 示 。 


BM @ 3:24 AM 


New contact 


Phone numbers 


a 
rc © 
4» 


Fmail addresses 


morr mmm mm 
bt pe pou pum pur pg ou pues ern ees 
| | 


图 2-19 单 击 Save 按钮 以 保存 
通过 上 述 操作 步骤 后 ， 即 可 添加 一 条 联系 人 的 数据 ， 如 图 2-20 所 示 。 


2.3.5 ”网 络 存储 


在 Android 系统 中 ,可 以 通过 网 络 实现 数据 存储 工作 。 在 早期 版 本 中 ， 曾 经 支持 用 XMPP 
Service 和 Web Service 进行 远程 访问 ， 但 是 从 Android SDK 1.0 以 后 不 再 支持 XMPP Service, 
而 且 访 问 Web Service 的 API 也 全 部 升级 了 。 
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图 2-20 添加 后 的 数据 


网 络 存 储 在 需要 及 时 更 新 类 型 的 项 目 中 比较 常用 ， 例 如 可 以 在 网 络 中 通过 邮政 编码 来 查 
询 该 地 区 的 天 气 预 报 。 实 现 原理 是 以 POST 方式 发 送 请 求 到 webservicex.net 站 点 ， 访 问 
WebService.webservicex.net 站 点 上 提供 查询 天 气 预 报 的 服务 , 具体 信息 请 参考 其 WSDL 文档 ， 
其 网 址 是 : 


http://www.webservicex.net/WeatherForecast.asmx? WSDL 


登录 后 可 以 查询 某 地 的 实时 天 气 状 况 ， 输 入 和 输出 信息 的 具体 说 明 如 下 。 

口 输入 : 某 个 城市 的 邮政 编码 。 

O 输出 : 该 邮政 编码 对 应 城市 的 天 气 预 报 。 

要 想 实 现 通过 邮政 编码 来 查询 该 地 区 的 天 气 预 报 的 功能 ， 可 以 通过 如 下 过 程 实现 。 

(OD 如 果 需 要 访问 外 部 网 络 ， 则 需要 在 文件 AndroidManifest.xml 中 加 入 如 下 申请 权限 许 
可 的 代码 。 


«BUB -> 
<uses-permission Android:name="Android.permission. INTERNET" /> 


(2) 以 HTTP POST If]; EXE, SERVER URL 并 不 是 指 WSDL 的 URL， 而 是 服务 本 
喘 的 URL。 具 体 实现 的 代码 如 下 。 


private static final String SERVER URL =  "http;//www.webservicex.net/WeatherForecast. 
asmx/GetWeatherBy ZipCode"; /定义 需要 获取 的 内 容 来 源 地 址 

HttpPost request = new HttpPost(SERVER. URL); /根据 内 容 来 源 地 址 创建 一 个 HTTP 请 求 
/ 添加 一 个 变量 
List <NameValuePair> params = new ArrayList <NameValuePair>(); 
/ 设置 一 个 华盛顿 区 号 
params.add(new BasicNameValuePair("ZipCode", "200120")); /添加 必须 的 参数 
request.setEntity(new UrlEncodedFormEntity(params, HTTP.UTF 8)); /设置 参数 的 编码 
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try 
{ 
HttpResponse httpResponse = new DefaultHttpClient().execute(request); // 发 送 请 求 并 获取 反馈 
/ 解析 返回 的 内 容 
if(httpResponse.getStatusLine().getStatusCode() != 404) 
{ 
String result = EntityUtils.toString(httpResponse.getEntity()); 
Log.d(LOG_TAG, result); 


} 


} catch (Exception e) { 
Log.e(LOG_TAG, e.getMessage()); 
} 


HSH 


通过 上 述 代码 ， 使 用 HITP 从 webservicex 获取 ZipCode Xy “200120” (GD WASHINGTON 
D.C) 的 内 容 ， 其 返回 的 内 容 如 下 。 


<WeatherForecasts xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi-"http: //www.w3.org/ 
2001/XMLSchema-instance" xmlns="http://www.webservicex.net"> 
<Latitude>38.97571</Latitude> 
<Longitude>77.02825</Longitude> 
<AllocationFactor>0.024849</AllocationFactor> 
<FipsCode>1 1</FipsCode> 
<PlaceName>W ASHINGTON</PlaceName> 
<StateCode>DC</StateCode> 
<Details> 
<WeatherData> 
<Day>Saturday, April 25, 2009</Day> 
<Weatherlmage>http://forecast.weather.gov/images/wtf/sct.jpg</WeatherImage> 
<MaxTemperatureF>88</MaxTemperatureF> 
<MinTemperatureF>57</MinTemperatureF> 
<MaxTemperatureC>3 1</MaxTemperatureC> 
<MinTemperatureC>14</MinTemperatureC> 
</WeatherData> 
<WeatherData> 
<Day>Sunday, April 26, 2009</Day> 
<WeatherIlmage>http://forecast.weather.gov/images/wtf/few.jpg</WeatherImage> 
<MaxTemperatureF>89</MaxTemperatureF> 
<MinTemperatureF>60</MinTemperatureF> 
<MaxTemperatureC>32</MaxTemperatureC> 
<MinTemperatureC>16</MinTemperatureC> 
</WeatherData> 


</Details> 
</WeatherForecasts> 
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通过 上 述 实现 过 程 ， 演 示 了 如 何在 Android 中 通过 网 络 获取 数据 。 要 掌握 这 方面 的 内 
容 ， 开 发 者 需要 熟悉 java.net.*，Android.net.* 这 两 个 包 的 内 容 ， 有 具体 信息 请 读者 参阅 相关 
文档 。 


2.4 访问 操作 SD 卡 〈 手 机 中 的 存储 卡 ) 


在 Android 平台 中 ， 可 以 在 如 下 两 个 位 置 对 文件 进行 读 写 操作 。 

口 SD 卡 。 

口 手机 的 存储 文件 夹 。 

使 用 IO 技术 可 以 对 上 述 位 置 存储 的 文件 进行 操作 。 但 是 基于 SD 卡 的 特殊 性 ,我 们 需要 
事先 实现 程序 对 SD 卡 的 访问 ， 才 能 操作 SD 卡 中 的 文件 。SD 卡 是 当前 智能 手机 的 一 部 分 ， 
我 们 经 常 在 SD 卡 中 存储 大 量 的 文件 ， 例 如 音乐 、 视 频 和 游戏 。 因 为 SD 卡 的 重要 性 ， 所 以 不 
可 避免 的 需要 涉及 操作 SD 卡 中 文件 的 知识 。 
其 实 访问 SD 卡 中 数据 的 方法 与 在 Java 中 进行 文件 读 取 操 作 的 方法 十 分 类 似 ， 只 需要 注 
意 正确 地 设置 文件 的 位 置 和 文件 名 即 可 。 

在 Android 模拟 器 中 ， 可 以 使 用 FAT32 格式 的 磁盘 镜像 作为 SD 卡 的 模拟 ， 具 体 过 程 
如 下 。 

(1) 进入 Android SDK 目录 下 的 tools 子 目 录 ， 然 后 运行 如 下 命令 。 


mksdcard -l sdcard 512M /your path for img/sdcard.img 


通过 上 述 命令 创建 了 一 个 SI2MB 大 小 的 SD 卡 镜像 文件 。 
(2) 通过 如 下 命令 运行 模拟 器 的 时 候 指定 路 径 ， 在 此 需要 使 用 完整 路 径 。 


emulator -sdcard /your path for img/sdcard.img 


这 样 在 模拟 器 中 就 可 以 使 用 /sdcard 这 个 路 径 来 指向 模拟 的 SD Er, 

接 下 来 需要 复制 本 机 文件 到 SD 卡 中 ， 甚 至 需要 管理 SD 卡 中 的 文件 内 容 。 通 过 如 下 两 种 
方案 可 以 实现 上 述 功能 

(1) Æ Linux 系统 下 可 以 挂 载 成 一 个 loop 设备 ， 例 如 先 创 建 一 个 名 为 “android_sdcard” 
的 目录 ， 然 后 执行 下 面 的 命令 。 


mount -o loop sdcard.img android sdcard 


这 样 可 以 通过 管理 这 个 目录 的 方式 管理 sdcard 内 容 。 
(2) 在 EE 可 视 环 境 下 也 可 以 用 mtools 来 实现 管理 ,并且 也 可 以 用 Android SDK H 
带 的 如 下 命令 (这 个 命令 在 Linux 下 面 也 可 以 用 ) 实现 。 


adb push local file sdcard/remote file 


在 执行 完 上 面 的 命令 后 ， 需 要 执行 下 面 的 命令 启动 Android 模拟 器 。 


emulator -avd avd! -sdcard card/mycard.img 
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如 果 在 Eclipse 开发 环境 
HJ LAXE Preferences 对 话 框 中 设 
了 装载 SD 卡 虚拟 文件 的 命令 


BS 


» ALAA 


在 接 下 来 的 内 容 中 ， 将 


通 


过 


E Run Configuration 对 话 框 中 设 
默认 启动 参数 。 这 样 在 新 建立 的 Android 工程 中 就 自动 加 入 
TEM. 

个 具体 实例 的 实现 过 程 


Bet 


讲解 读 取 SD 卡 中 数据 的 方法 。 


启 


T 


例 


功 


a6 
He 


源码 路 径 


实例 2-4 


操作 内 存 和 SD 卡 中 的 文件 


daima\2\SDP 


2.4.1 解决 思路 


移动 手机 的 存储 控件 分 为 内 存 控 件 和 存储 卡 控 伯 
分 别 用 于 添加 和 删除 内 存 或 存储 卡 内 的 文件 。3 
Activity; 53 PIA 2) 9H] T ATI 


式 显 示 里 面 的 所 有 的 目录 和 文件 名 ， 


“添加 ”按钮 后 会 显示 一 个 添加 
定 的 文件 。 


2.4.2 ”具体 实现 
本 实例 


的 具体 实现 流程 。 


菜单 ， 


内 存 卡 和 存储 -| 


实现 添加 文件 功能 。 


CD 编写 文件 SDC.java， 上 其 体 实现 流程 如 下 。 
O 用 方法 getFilesDir()3XHX SD 


的 状态 。 


/* 取得 目前 File 目录 si 
fileDir = this.getFilesDir(); 
* 取得 SD 卡 目录 */ 


对 应 代码 如 下 。 


F。 在 本 实例 的 屏幕 中 添加 了 
HME EH] 3 个 Activity, 其 中 
上 E。 当 用 户 选择 内 存 或 存储 卡 后 ， 
并 在 Menu 菜单 中 显示 “添加 ”或 “删除 ”按钮 。 单 各 


两 个 按钮 ， 


VJ 


3 


程序 是 Entry 
名 


年 以 列表 天 


^N 


Me 


fen 


当 单 击 “ 删 除 ”按钮 后 可 以 删除 指 


的 实现 文件 是 SDC.java、SDC 1.java fll SDC 2.java， 接 下 来 将 分 别 介绍 上 述 文件 


FE 的 目录 , 设置 当 SD 


sdcardDir = Environment.getExternalStorageDirectory(); 
/* 当 SD 卡 无 插入 时 将 myButton2 设 成 不 能 按 ai 
if (Environment.getExternalStorageState().equals(Environment.MEDIA REMOVED)) 


E 


F setOnClickListener()fll setOnClickListener(); 


myButton1.setOnClickListener(new Button.OnClickListener() 


{ 
myButton2.setEnabled(false); 
} 
口 分 别 定义 按钮 单 击 处 至 
码 如 下 。 
{ 
@Override 


public void onClick( View arg0) 


{ 


String path = fileDir.getParent() + java.io.File.separator 
+ fileDir.getName(); 


ECO A DË myButton2 处 于 不 能 按 


LA 
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showListActivity(path); 
} 
Di 
myButton2.setOnClickListener(new Button.OnClickListener() 
{ 
@Override 
public void onClick(View arg0) 
{ 
String path = sdcardDir.getParent() + sdcardDir.getName(); 
showListActivity(path); 


35 
j 


O 定义 方法 showListActivity(String path), fx X. —^ Intent 对 象 intent， 然 后 将 路 径 传 


到 SDC 1。 有 具体 代码 如 下 。 


private void showListActivity(String path) 
{ 
Intent intent = new Intent(); 
intent.setClass(SDC.this, SDC 1.class); 
Bundle bundle = new Bundle(); 
[* 将 路 径 传 到 example 1 */ 
bundle.putString("path", path); 
intent.putExtras(bundle); 
startActivity(intent); 


j 


(2) 编写 文件 SDC ljava, HFUASCBLUEEBI F. 
O 将 主 Activity 传 来 的 path (路径 ) 字符 串 作 为 传 入 路 径 ， 
用 java.io.File 创建 一 个 新 的 。 有 具体 代码 如 下 。 


public class SDC 1 extends ListActivity 
{ 
private List<String> items = null; 
private String path; 
protected final static int MENU_NEW = Menu.FIRST; 
protected final static int MENU_DELETE = Menu.FIRST + 1; 
@Override 
public void onCreate(Bundle savedInstanceState) 
{ 
super.onCreate(savedInstanceState); 
setContentView(R.layout.ex06 09 1); 
Bundle bunde - this.getIntent().getExtras(); 
path = bunde.getString("path"); 
java.io.File file = new java.io.File(path); 
50 EI 


如 果 不 存 在 这 个 路 径 ， 


则 使 
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Is 当 该 目录 不 存在 时 将 创建 目录 */ 
if (!file.exists()) 
1 
file.mkdir(); 
} 
fill(file.listFiles()); 


} 


O 通过 onOptionsItemSelected 根据 单 击 的 MENU 选项 实现 添加 或 删除 操作 ， 有 具体 代码 
如 下 。 


public boolean onOptionsItemSelected(Menultem item) 
{ 
super.onOptionsItemSelected(item); 
switch (item.getItemId()) 
{ 
case MENU_NEW: 
Pats MENU */ 
showListActivity(path, "", ""); 
break; 
case MENU DELETE: 
/* 点 击 删除 MENU */ 


deleteFile(); 
break; 

} 

return true; 


j 


O 使 用 onCreateOptionsMenu(Menu menu) 添 加 需要 的 MENU， 上 有 具体 代码 如 下 。 


@Override 

public boolean onCreateOptionsMenu(Menu menu) 

1 
super.onCreateOptionsMenu(menu); 
/* 添加 MENU */ 
menu.add(Menu.NONE, MENU NEW, 0, R.string.strNewMenu); 
menu.add(Menu.NONE, MENU DELETE, 0, R.string.strDeleteMenu); 
return true; 


j 
D 当 单 击 文件 名 后 获取 文 伯 


WA, BAIT. 


TT 


protected void onListItemClick 
(ListView l, View v, int position, long id) 
1 
File file = new File 
(path + java.io.File.separator + items.get(position)); 
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P 点 击 文件 取得 文件 内 容 */ 
if (file.isFile()) 
1 
String data = ""; 
try 
{ 
FileInputStream stream = new FileInputStream(file); 
StringBuffer sb — new StringBuffer(); 
int c; 
while ((c = stream.read()) != -1) 
1 
sb.append((char) c); 
} 
stream.close(); 
data = sb.toString(); 
} 
catch (Exception e) 
1 
e.printStackTrace(); 
} 
showListActivity(path, file.getName(), data); 
} 
} 


O 使 用 方 


tT 


一 < 


2; fill(File[] files) 将 内 容 填充 到 文件 ， 有 具体 代码 如 下 。 


private void fill(File[] files) 
t 
items = new ArrayList<String>(); 
if (files == null) 
1 
return; 
j 
for (File file : files) 
1 
items.add(file.getName()); 
j 
Array AdaptersString^ fileList = new ArrayAdaptersString^ 
(this,android.R.layout.simple list item 1, items); 
setListA dapter(fileList); 
j 


O 使 用 showListActivity 来 显示 已 经 存在 的 文件 列表 ， 具 体 代码 如 下 。 


private void showListActivity 
(String path, String ilename, String data) 
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Intent intent = new Intent(); 
intent.setClass(SDC 1.this, SDC_2.class); 
Bundle bundle = new Bundle(); 
POSTER = 

bundle.putString(“path”, path); 

F zehra A 

bundle.putString(“ ilename", ilename); 
/* 文件 内 容 */ 

bundle.putString(“data”, data); 
intent.putExtras(bundle); 
startActivity(intent); 


Re 


口 使 用 方 


去 deleteFile0 删 除 选 定 的 文件 ， 上 具体 代 码 如 下 。 


private void deleteFile() 
1 
int position — this.getSelectedItemPosition(); 
if (position >= 0) 
1 
File file = new File(path + java.io.File.separator + 
items.get(position)); 
入 删除 文件 */ 
file.delete(); 
items.remove(position); 


getListView().1nvalidate Views(); 


j 


(3) 编写 文件 SDC_ 2.java， 具 体 实现 流程 如 下 。 
O 设置 myEditTextl 来 放置 文件 内 容 , 然后 定义 Bundle 对 象 bunde 来 获取 路 径 path 和 数 
据 data。 具 体 代码 如 下 。 


public void onCreate(Bundle savedInstanceState) 
{ 
super.onCreate(savedInstanceState); 
setContentView(R.layout.ex06 09 2); 
/* 放置 文件 内 容 的 EditText */ 
myEditText1 = (EditText) find ViewByld(R.id.myEditText1); 
Bundle bunde = this.getIntent().getExtras(); 
path = bunde.getString("path"); 
data = bunde. getString("data"); 
fileName = bunde. getString("fileName"); 
myEditTextl.setText(data); 
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口 使 用 onOptionsItemSelectedO) 根 据 用 户 选 择 而 进行 操作 ， 当 选择 MENU SAVE 时 会 保 
存 这 个 文件 。 具 体 代码 如 下 。 


public boolean onOptionsItemSelected(Menultem item) 
{ 
super.onOptionsItemSelected(item); 
switch (item.getItemId()) 
{ 
case MENU_SAVE: 
saveFile(); 
break; 
j 


return true; 


j 


口 使 用 onCreateOptionsMenu(Menu menu) 添 加 一 个 MENU， 有 具体 代码 如 下 。 


@Override 
public boolean onCreateOptionsMenu(Menu menu) 


{ 
super.onCreateOptionsMenu(menu); 
/* 添加 MENU */ 
menu.add(Menu.NONE, MENU SAVE, 0, R.string.strSaveMenu); 
return true; 


j 


O 使 用 方法 saveFileO 保 存 一 个 文件 。 定 义 LayoutInflater AS factory 用 于 跳出 存档 ， 
然后 通过 myDialogEditText0 获 取 Dialog 中 的 EditText， 最 后 实现 存档 处 理 。 有 具体 代 
码 如 下 。 


private void saveFile() 
{ 
/* 跳出 存档 的 Dialog */ 
LayoutInflater factory = LayoutInflater.from(this); 


final View textEntryView = factory.inflate 
(R.layout.save dialog, null); 
Builder mBuilderl = new AlertDialog.Builder(SDC 2.this); 
mBuilderl.setView(textEntry View); 
/* 取得 Dialog 里 的 EditText */ 
myDialogEditText = (EditText) textEntryView.findViewByld 
(R.id.myDialogEditText); 

myDialogEditText.setText(fileName); 
mBuilder1.setPositiveButton 
( 

R.string.str alert ok,new DialogInterface.OnClickListener() 


1 


public void onClick(DialogInterface dialoginterface, int i) 
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1 
/* 存档 */ 
String Filename = path + java.io.File.separator 
+ myDialogEditText.getText().toString(); 
java.io.BufferedWriter bw; 
try 
{ 


bw = new java.io.Buffered Writer(new java.io.FileWriter( 


new java.io.File(Filename))); 
String str = myEditText1.getText().toString(); 
bw.write(str, 0, str.length()); 
bw.newLine(); 
bw.close(); 
} 
catch (IOException e) 
{ 
e.printStackTrace(); 
} 
/* 回 到 SDC 1 */ 
Intent intent = new Intent(); 
intent.setClass(SDC_2.this, SDC_1.class); 
Bundle bundle = new Bundle(); 
/* 将 路 径 传 到 SDC 1 */ 
bundle.putString("path", path); 


intent.putExtras(bundle); 
startActivity(intent); 
finish(); 
j 
D 
mBuilderl.setNegativeButton(R.string.str alert cancel, null); 
mBuilderl.show(); 


} 
执行 后 的 效果 如 图 2-21 所 示 ， 当 单 击 一 个 按钮 后 会 显示 对 应 的 存储 信息 ， 如 图 2-22 所 
示 。 当 单 击 图 2-22 中 的 “menu” 后 ， 会 弹出 两 个 menu 选项 ， 如 图 2-23 所 示 。 此 时 ， 可 以 
通过 这 两 个 选项 分 别管 理 存 储 卡 中 的 数据 。 


Du 


= z wl @ 2:17 


获取 手机 的 内 存 


图 2-21 初始 效果 图 2-22 SD 卡 的 文件 信息 
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K|2-23 fii MENU 按钮 


注意 : 在 “Eclipse+Android SDK” 开 发 环境 中 ， 可 以 在 可 视 化 模式 下 管理 SD T vx 
件 ， 具 体 方 法 如 下 。 

(1) #2 Eclipse 右上 角 的 DDMS 选项 卡 ， 如 图 2-24 所 示 。 

(2) 在 右 侧 列表 中 单 击 mnt 选项 ， 其 中 的 sdcard 文件 夹 就 是 系统 模拟 的 SD 卡 目录 ， 如 
图 2-25 所 示 。 


EŒ DDNS - SDC/r s. xm. clipse 
File Edit Run Navigate Search Project Refactor Window Help 


Cie Jä lEs éla- Jog] a EO ms & Java 


HG asec 2011-09-25 
田 色 obb 2011-09-25 

日 G sdceré 1970-01-01 

国 12: 86226 2011-09-21 

2011-09-21 

i [n] xl , 加 IE 2011-09-04 
2 = 2011-09-25 


2010-11-24 
ES ££ nms CA Java 
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Telephony Actions — — — — — — ——4 
| m ES |x 日 | 名 Incoming mmber: TË 
Fina Q | P AL b Activate... A 
图 2-24 “DDMS” 选 项 卡 图 2-25 SD FEX 


(3) 通过 顶部 中 的 工具 按钮 可 以 对 SD 卡 进行 操作 ， 如 图 2-26 所 示 。 


LK IA tT" 
图 2-26 操作 SD 卡 的 按钮 


2-22 中 操作 按钮 的 具体 说 明 如 下 。 
OR FE SD 卡 中 的 文件 到 本 地 。 
口 罚 ， 上 传 本 地 文件 到 SD 卡 。 
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a $. 在 SD 卡 中 新 建文 件 。 
D", 删除 SD 卡 中 的 某 个 文件 。 


25 ”总结 和 网 络 开发 有 关 的 包 


T 


fr Android 系统 中 进行 网 络 项 目 开 发 时 ， 需 要 用 到 Android SDK 中 为 我 们 提供 的 包 ， 这 
些 包 的 具体 说 明 如 表 2-2 所 示 。 


表 2-2 Android SDK 中 和 网 络 有 关 的 包 


TEE 提供 与 联网 有 关 的 类 ， 包 括 流 和 数据 包 (datagram) sockets, Internet 协议 和 常见 的 HTTP 处 理 。 
Jaye 该 包 是 一 个 多 功能 网 络 资源 。 有 经 验 的 Java 开发 人 员 可 以 立即 使 用 此 包 创 建 应 用 程 请 
inda 虽然 没有 提供 显 式 的 联网 功能 , 但 是 仍然 非常 重要 。 该 包 中 的 类 由 其 他 Java 包 中 提供 的 socket 和 
连接 使 用 ， 并 且 还 用 于 与 本 地 文件 〈 在 与 网 络 进行 交互 时 会 经 常 出 现 ) 的 交互 
java.nio 包含 表示 特定 数据 类 型 的 缓冲 区 的 类 。 适 合用 于 两 个 基于 Java 语言 的 端点 之 间 的 通信 
org.apache.* 表示 许多 为 HTTP 通信 提供 精确 控制 和 功能 的 包 ， 可 以 将 Apache 视 为 流行 的 开源 Web 服务 器 
android.net 除 核心 javanet.* 类 以 外 ,包含 额外 的 网 络 访问 socket. AHH URI 类 ， 后 者 频繁 用 于 Android 
应 用 程序 开发 ， 而 不 仅仅 是 传统 的 联网 方面 
android.net.http 包含 处 理 SSL 证 书 的 类 
android net wifi 包含 在 Android 平台 上 管理 有 关 WiFi (802.11 无 线 Ethernet) 所 有 方面 的 类 。 并 不 是 所 有 设备 都 配 
We 备 了 WiFi 功能， 特别 是 Android 在 Motorola 和 LG 等 手机 制造 商 的 “翻盖 手机 ”领域 获得 了 成 功 
android.telenhonv.gsm 包含 用 于 管理 和 发 送 SMS OR) 消息 的 类 。 一 段 时 间 后 ， 可 能 会 引入 额外 的 包 来 为 非 GSM 网 络 
in iin 提供 类 似 的 功能 ， 比 如 CDMA EÈ android.telephony.cdma 等 网 络 
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因为 大 多 数 Android 应 用 程序 是 使 用 Java 语言 编写 的 , 所 以 在 Android 网 络 应 用 程序 中 ， 
通常 使 用 Java 网 络 包 来 传输 网 络 数据 。 另 外 ,在 Android 平台 中 ， 通 常 需要 使 用 Java 中 的 网 
络 通信 协议 来 开发 HTTP 通信 项 目 。 在 本 章 的 内 容 中 ， 将 详细 讲解 在 Android 系统 中 所 用 到 
的 Java 网 络 包 技 术 ， 并 详细 讲解 这 些 网 络 包 的 基本 用 法 。 


3.1 Java 中 的 网 络 包 


fr Java 中 提供 了 专门 的 包 来 支持 网 络 应 用 ， 在 包 java.net 中 通过 类 URL 和 类 
URLConnection 以 编程 方式 访问 Web 服务 ， 通 过 类 URLDecoder 和 类 URLEncoder 提供 了 普 
通 字符 串 和 application/x-www-form-urlencoded MIME 字符 串 相 互 转换 的 静态 方法 。 


3.1.1 InetAddress 类 详解 


在 Java 应 用 中 ， 使 用 类 InetAddress 来 处 理 IP 地 址 的 数据 传输 工作 。 在 类 InetAddress 中 
还 存在 如 下 的 两 个 子 类 。 

口 Inet4Address: 表示 Internet Protocol version 4 (IPv4) 地 址 。 

O Inet6Address: 表示 Internet Protocol version 6 (IPv6) 地 址 。 

TE Java 应 用 中 ， 类 InetAddress 没有 构造 器 ， 只 是 提供 了 如 下 两 个 静态 方法 来 获取 
InetAddress 实例 。 

口 getByName(String host): 根据 主机 获取 对 应 的 InetAddress 对 象 。 

口 getByAddress(byte[] addr): 根据 原始 IP 地址 来 获取 对 应 的 InetAddress 对 象 。 

在 类 InetAddress 中 ， 可 以 通过 如 下 三 个 方法 来 获取 InetAddress 实例 对 应 的 IP 地 址 和 主 
机 名 。 
口 String getCanonicalHostName(): 获取 此 IP 地 址 的 完全 限定 域名 。 

O String getHostAddress(): 返回 该 metAddress 实例 对 应 的 IP 地 址 字符 串 〈 以 字符 串 
形式 )。 

口 String getHostName(): 获取 此 IP 地 址 的 主机 名 。 

在 类 InetAddress 中 包含 了 如 下 的 两 个 重要 方法 。 
口 getLocalHost(): 获取 本 机 IP 地 址 对 应 的 InetAddress 实例 。 

口 isReachable(): 测试 是 否 可 以 到 达 该 地 址 ， 该 方法 的 实现 将 尽 最 大 努力 试图 到 达 主 机 ， 
但 防火 墙 和 服务 器 配置 可 能 阻塞 请 求 ， 使 其 在 某 些 特定 的 端口 可 以 访问 时 处 于 不 可 达 
的 状态 。 如 果 可 以 获得 权限 ， 则 将 使 用 ICMP ECHO REQUEST (PING 信息 ) 进行 应 
答 ; 否则 它 将 试图 在 目标 主机 的 端口 上 建立 TCP 连接 。 
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3.1.2 URLDecoder 类 和 URLEncoder 类 
在 Java 应 用 中 ， 类 URLDecoder 和 类 URLEncoder 的 功能 是 实现 普通 字符 串 和 


application/x-www-form-urlencoded MIME 字符 串 的 相互 转换 。 虽 然 application/x-www-form- 
urlencoded MIME 不 是 普通 的 字符 串 , 但 是 在 现实 应 用 中 经 常见 到 , 例如 搜索 引擎 网 址 中 看 似 


是 乱码 的 内 容 ， 如 图 3-1 所 示 。 


$$ &aqi=&aql=a&gs_sm=&gs_up|=&bav=on.2,or.r_gc.r_pw.,cf.osb&fp=7d739249df327f8&biw=1272&bih=594 Q9 i ~ 


图 3-1 MME 字符 串 


当 URL 地 址 中 包含 非 西欧 字符 的 字符 串 时 ， 系 统 会 将 这 些 非 西欧 字符 串 转换 成 如 图 3-1 

所 示 的 特殊 字符 串 。 在 编程 过 程 中 可 以 将 普通 字符 串 和 这 种 特殊 字符 串 相关 转换 ， 此 功能 是 

通过 使 用 类 URLDecoder 和 类 URLEncoder 实现 的 。 

口 类 URLDecoder: 包含 一 个 decode(String s,String enc) 静 态 方法 ， 它 可 以 将 看 上 去 是 乱 

码 的 特殊 字符 串 转 换 成 普通 字符 串 。 

O 类 URLEncoder: 包含 一 个 encode(String s,String enc) 静 态 方法 ， 它 可 以 将 普通 字符 串 

转换 成 application/x-www-form-urlencoded MIME 字符 串 。 

在 实际 应 用 中 , 无 须 转 换 仅 包 含 西欧 字符 的 普通 字符 串 和 application/x-www-form-urlencoded 

MIME 字符 串 。 但 是 需要 转换 包含 中 文字 符 的 普通 字符 串 ， 转 换 的 方法 是 每 个 中 文字 符 占 2 

个 字 节 , 每 个 字 节 可 以 转换 成 2 个 十 六 进 制 的 数字 , 所 以 每 个 中 文字 符 将 转换 成 “%XX%XX” 

的 形式 。 当 采用 不 同 的 字符 集 时 ， 每 个 中 文字 符 对 应 的 字 节 数 并 不 完全 相同 ， 所 以 使 用 类 
URLEncoder 和 类 URLDecoder 进行 转换 时 ， 也 需要 指定 字符 集 。 


3.1.3 URL 和 URLConnection 


在 计算 机 应 用 技术 中 , URL Æ Uniform Resource Locator 的 缩写 , 意思 是 统一 资源 定位 器 。 
URL 是 指向 互联 网 “资源 ”的 指针 ， 这 里 的 资源 可 以 是 简单 的 文件 或 目录 ， 也 可 以 是 对 更 为 
复杂 的 对 象 引用 ， 例 如 对 数据 库 或 搜索 引擎 的 查询 。 在 大 多 数 情 况 下 ，URL 是 由 协议 名 、 主 
机 、 端 口 和 资源 组 成 的 ，URL 需要 满足 如 下 的 格式 。 


protocol://host:port/resourceName 
例如 下 面 就 是 一 个 URL 地 址 。 


http://www.163.com 


JDK 为 用 户 提供 了 一 个 URI 类， 其 代表 一 个 统一 资源 标识 符 。Java 的 URI 不 能 用 于 定位 
任何 资源 ， 它 唯一 的 作用 是 解析 。 在 URL 中 包含 了 一 个 可 以 打开 到 达 该 资源 的 输入 流 ， 因 此 
可 以 将 URL 类 理解 为 URI 的 一 个 特例 。 

在 URL 类 中 ,提供 了 多 个 可 以 创建 URL 对 象 的 构造 器 ， 一旦 获得 了 URL 对 象 之 后 ， 就 
可 以 调用 下 面 的 方法 来 访问 该 URL 对 应 的 资源 。 

O String getFile0: 获取 此 URL 的 资源 名 。 
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口 String getHost(): 获取 此 
O String getPath(): 获取 此 


引用 的 远程 对 象 的 连接 。 

LI InputStream openStream( 
的 InputStream. 

在 URL 中 ， 可 以 使 用 方法 


URL 的 主机 名 。 
URL 的 路 径 部 分 。 


T int getPort(): 获取 此 URL 的 端口 号 。 

口 String getProtocol0: 获取 此 URL 的 协议 名 称 。 

T String getQuery(): 获取 此 URL 的 查询 字符 串 部 分 。 

C] URLConnection openConnection(): 返回 一 个 URLConnection 对 象 ， 它 表示 到 URL 所 


): 打开 与 此 URL 的 连接 ， 并 返回 一 个 用 于 读 取 该 URL 资源 


openConnection0 返 回 一 个 URLConnection 对 象 ， 该 对 象 表示 


应 用 程序 和 URL 之 间 的 通信 链接。 应 用 程序 可 以 通过 URLConnection 实例 向 此 URL 发 送 请 


求 ， 并 读 取 URL 引用 的 资源 


创建 一 个 和 URL 连接 的 ， 并 发 送 请 求 ， 读 取 此 URL 引用 的 资源 的 步骤 如 下 : 
CD 通过 调用 URL 对 象 openConnection() 方 法 来 创建 URLConnection 对 象 。 


(2) 设置 URLConnection 的 参数 和 普通 请 求 属性 。 


(3) 如 果 只 是 发 送 GET 方式 请 求 ， 使 用 方法 connect 建立 和 远程 资源 之 间 的 实际 连接 即 
nf. 如 果 需 要 发 送 POST 方式 的 请 求 ， 需 要 获取 URLConnection 实例 对 应 的 输出 流 来 发 送 请 


(4) 远程 资源 变 为 可 用 ， 程 序 可 以 访问 远程 资源 的 头 字段 或 通过 输入 流 读 取 远 程 资源 的 


数据 。 


在 建立 和 远程 资源 的 实际 连接 之 前 ， 可 以 通过 如 下 方法 来 设置 请 求 头 字 段 。 


段 的 值 。 


O setAllowUserInteraction: 设置 该 URLConnection 的 allowUserInteraction 请 求 头 字 
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C] setDoInput: 设置 该 URLConnection 的 doInput 请 求 头 字段 的 值 。 
O setDoOutput: 设置 该 URLConnection 的 doOutput 请 求 头 字段 的 值 。 
口 setIfModifiedSince: 设置 该 URLConnection 的 ifModifiedSince 请 求 头 字段 的 值 。 


O setUseCaches: 设置 该 UU 


PAMELA value. 
QO) addRequestProperty(String 


'RLConnection 的 useCaches 请 求 头 字段 的 值 。 


除 此 之 外 ， 还 可 以 使 用 如 下 方法 来 设置 或 增加 通用 头 字 段 。 
O setRequestProperty(String key, String value): 设置 该 URLConnection 的 key， 请 求 头 字 


key, String value): 为 该 URLConnection 的 key 请 求 头 字段 的 增加 


value 值 ， 该 方法 并 不 会 覆盖 原 请 求 头 字段 的 值 ， 而 是 将 新 值 追加 到 原 请 求 头 字段 中 。 


当 发 现 远程 资 源 可 以 使 用 后 ， 使 用 如 下 方法 访问 头 字段 和 内 容 。 

口 Object getContent(): 获取 该 URLConnection 的 内 容 。 

口 String getHeaderField(String name): 获取 指定 响应 头 字段 的 值 。 

O getInputStream(): 返回 该 URLConnection 对 应 的 输入 流 ， 用 于 获取 URLConnection D 


应 的 内 容 。 
C] getOutputStream(): 返回 
送 请 求 参数 。 
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该 URLConnection 对 应 的 输出 流 ， 用 于 向 URLConnection 发 
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口 getHeaderField: 根据 响应 头 字段 来 返回 对 应 的 值 。 


尾 头 字段 的 值 。 
Q getContentEncoding: 获取 content-encoding 响应 头 字 段 的 值 。 
O getContentLength: 获取 content-length 响应 头 字段 的 值 。 

O getContentType: 获取 content-type 响应 头 字段 的 值 。 

O getDate0: 获取 date 响应 头 字 段 的 值 。 
口 getExpiration(): 获取 expires 响应 头 字段 的 值 。 

口 getLastModified(): 获取 last-modified 响应 头 字 段 的 值 。 


因为 在 程序 中 需要 经 常 访问 某 些 头 字段 ， 所 以 Java 为 用 户 提供 了 如 下 方法 来 访问 特定 响 


在 编程 过 程 中 ， 无 需 担 心 普通 Java 平台 和 Android 平台 的 差异 ，URLConnection 在 Java 


中 的 用 法 就 是 在 Android 应 用 中 的 用 法 。 在 接 下 来 的 内 容 中 ， 将 通过 一 个 具体 实例 来 讲解 在 


Android 系统 中 使 用 类 URLConnection 的 基本 方法 。 


x B 功 能 源码 


路 径 


实例 3-1 在 手机 屏幕 中 显示 QQ 空间 中 的 照片 daima\3\QQ 


本 实例 的 功能 是 ,在 Gallery 中 显示 某 个 指定 QQ 空间 中 的 照片 ， 这 样 做 的 好 处 是 节约 手 


机 的 内 置 存储 空间 。 在 有 共 体 实现 上 ， 需 要 将 URL 网 址 的 相片 实时 处 理 下 载 后 ， 


H 


LX InputStream 


转换 为 Bitmap， 这 样 才能 放 入 BaseAdapter PRH. ZITARI, made TOL 
传 到 网 络 空间 中 ， 在 获取 相片 的 连接 后 ， 再 以 String 数组 方式 放 在 程序 中 ， 
稍 作 修改 ， 再 加 上 对 URL 对 象 的 访问 以 及 URLConnection 连接 的 处 理 。 

本 实例 的 具体 实现 流程 如 下 。 


T 


E 准 备 照片 并 上 


并 对 BaseAdapter 


C1) 编写 布局 文件 main.xml， 在 里 面 插入 了 一 个 Gallery 控件 来 实现 滑动 相 短 效果 。 有 具体 


代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/myLinearLayout" 
android:orientation="Vvertical" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent"> 
<Gallery 
android:id="@-+id/myGallery0 1" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent"> 
</Gallery> 

</LinearLayout> 


a 编写 主 程序 文件 QQ.java， 其 具体 实现 流程 如 下 。 
分 别 声明 在 Gallery 中 要 显示 的 5 副 图 片 的 地 址 栏 字符 上 


public class QQ extends Activity 
H 


UI 
L 


private Gallery myGallery01; 
P 地 址 栏 字符 串 C 


具体 代码 如 下 。 
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private String[] myImageURL = new String[] 
{ 
"http://b236.photo.store.qq.com/psb?/" 

t "VIANjoEBtl VPfcS/vJl L£ÉTWqLK vNO2BBOPinvINjCSdCV3RcEA4BhdhAD3ZA !/b/ 
dFr6toyNCAAA &bo-GgNIAgAAAAABB3M!&rf-viewer 4", 

"http://b241.photo.store.qq.com/psb?/" 

+ "VIANjoBtl VPfcS/*vD8rcyIXK GzlpNd8UPb45Y dQrZySDINh*OWgtMASDS!/b/ 

dJvMqI8ACAAA&bo=* gKAAgAAAAABB 14! &rf=viewer_4", 
"http://b239.photo.store.qq.com/psb?/" 

+ "VIANjoBtl VPfcS/Xm942*QSSEV2kCwETcv9e4PHFtRcWrs1 OnaTomAR.jM!/b/ 

dHu8gI58CAAA&bo-IANY ASAAAAABBIk!&rf-viewer 4", 
"http://b27.photo.store.qq.com/http_imgload.cgi?/" 

+ "rurl4 b=2a9dcf1fd909a7ed3ce8951£73860898bb7ff57a8cb7747c9 f0eb6a02 124850b709 
c0b86f086a4ba5653 eeb7 1 dd4b01e4a58f407e2eec9433cd8d4bc0b88fda56260c2c8beb3 4ebab7 7b610c7 131393f82e7 
T4ef&a=27 &b=27", 

"http://b27.photo.store.qq.com/http_imgload.cgi?/" 

+ "rurl4 b-2a9dcf1fd909a7ed3ce8951f73860898158d252489f84e7d2a83d44c01b7bb12b2c 
19ca0efdd555dba788407fd01e9de45524b11297931532624197bc8d14c84ae78ddebafe4357e4eedc60e9e5102243674 
90bf&a-27&b-27" Y; 


O 引入 布局 文件 main.xml， 定 义 类 成 员 myContext H Context 对 象 ， 然 后 设置 只 有 一 个 
参数 C 的 构造 器 。 有 具体 代码 如 下 。 


public void onCreate(Bundle savedInstanceState) 
{ 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
myGallery01 = (Gallery) findViewByld(R.id.myGallery01); 
myGallery01.setAdapter(new myInternetGalleryA dapter(this)); 
j 
/* Hj BaseAdapter */ 
public class myInternetGallery Adapter extends BaseAdapter 
{ 
/* 类 成 员 myContext, Context 对 象 */ 
private Context myContext; 


private int mGalleryItemBackground; } 

证 构造 器 只 有 一 个 参数 ， 即 要 存储 的 Context */ 
public myInternetGallery Adapter(Context c) 

{ 


this.myContext = c; 


TypedArray a = myContext 
.obtainStyledAttributes(R.styleable.Gallery); 

/* ”获取 Gallery 属性 的 Index id */ 

mGalleryltemBackground = a.getResourceld( 
R.styleable.Gallery android galleryItemBackground, 0); 

Je 把 对 象 的 styleable 属性 能 够 反复 使 用 */ 
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a.recycle(); 


} 


O 定义 方法 getCount0 来 返回 全 部 已 定义 图 片 的 总 量 , 定义 方法 getItem(int position) 3k Di 
当前 容器 中 图 像 数 的 数组 ID 。 有 具体 代码 如 下 。 


庶 ” 返 回 全 部 已 定义 图 片 的 总 量 a 
public int getCount() 


{ 
return myImageURL. length; 
j 
/* 使 用 getltem DIAIR BU ras PA ID */ 
public Object getItem(int position) 
{ 
return position; 
} 
public long getItemId(int position) 


i 
return position; 


j 
O 定义 方法 getScale, JH] getScale 根据 中 央 位 移 量 返回 views 的 大 小 。 具 体 代码 如 下 。 


/* 根据 中 央 位 移 量 ， 利 用 getScale 返回 views 的 大 小 (0.0fto 1.0f) */ 
public float getScale(boolean focused, int offset) 


{ 
/* Formula: 1 / (2 ^ offset) */ 


return Math.max(0, 1.0f / (float) Math.pow(2, Math.abs(offset))); 
} 


执行 后 将 在 Gallery 中 显示 指定 的 图 片 ， 如 图 3-2 所 示 。 


图 3-2 执行 效果 
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在 Java 应 
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HJF, URLConnection 是 一 个 典型 的 抽象 类 。 类 URLConnection 有 两 个 直 


接 子 类 ， 分 别 是 HttpURLConnection 和 JarURLConnection。 通 常 URL 可 以 通过 给 构造 器 传 一 


个 String 类 型 的 参数 的 方式 ， 生 成 一 个 指向 特定 地 二 
在 Java 应 
以 透明 地 共享 i 


Wess 


Hf. 每 个 HtpURLConnection. 实例 都 可 生成 单 
Lokal HTTP 服务 器 


LA URL 实例 。 


个 请 求 , 但 是 其 
上 1 网络。 当 生 成 请 求 后 ， 在 HttpURLConnection 的 


也 实例 可 


InputStream 或 OutputStream 上 调用 close() 方法 来 释放 与 此 实例 关联 的 网 络 资源 , 但 这 对 共 


享 的 持久 连 


会 关闭 基础 套 接 字 。 


在 日 常 应 用 中 ， 经 常 不 需要 将 网 络 


内 容 而 已 。 此 时 可 以 使 
据 。 例 如 在 下 面 的 实例 


FP 的 图 片 保 存在 
JÆ HttpURLConnection 1]7 
中 ， 使 用 类 HttpURLConnection 连接 3 


数据 用 InputStream 的 方式 保存 在 内 存 空间 中 。 本 实例 的 具体 实现 流程 


到 我 们 的 手机 


Iran, Gr 


接 没 有 任何 影响 。 如 果 在 调用 disconnect) 时 发 生 持 和 久 连 接 空 闲 的 情况 ， 则 可 能 


， 只 是 在 线 浏 览 一 下 


i 可 以 获取 链接 ! 


的 数 


获取 网 络 中 的 数据 ， 将 才 
EP. 


KI mp 


d i X 能 源码 路 径 
实例 3-2 在 手机 屏幕 中 显示 网 络 中 的 图 片 daima\3\tu 


C1) 编写 布局 文 伯 


<LinearLayout 


F main.xml, 


主要 实现 代码 如 


4| 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:background="(@drawable/white" 


android:orientation="Vertical" 


android:layout_width="fill_parent" 


android:layout_height="fill_parent" > 


<TextView 


android:id="@-+id/myTextView1" 
android:layout_width="fill_parent" 


android:layout height-"wrap content" 


android:text="@string/app_name"/> 


<Button 


android:id="@+id/myButton 1" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text="@string/str_button1" /> 


<ImageView 


android:id="@-+id/myImageView1" 


android:layout_width= 
android:layout_height= 


wrap content" 


wrap content" 


android:layout_gravity="center" /> 


</LinearLayout> 


(2) 编写 主 程序 文 
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ft tnjava， 首 先 


法 getURLBitmapO 将 图 


片 作为 参数 传 入 到 创建 


主要 实现 代码 如 下 。 


viewer 4"; 


public class tu extends Activity 


1 


private Button mButton1; 


private TextView mTextView1; 


private ImageView mImageView1; 
String uriPic = " http://b236.photo.store.qq.com/psb?/%22+%20%22 V 14NjoEtl VPfcS/vJ1 LfTwqLKv 
NO2BBOPinvINjCSdCV3RcEA4BhdhAD3ZA/b/dFr6toyNCAAA &bo=GgNIA gAAAAABB3M! &rf= 


@Override 


public void onCreate(Bundle savedInstanceState) 


1 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 


连接 图 片 的 mputStream。 文 从 
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的 URL 对 象 中 ， 然 后 通过 方法 getInputStream() žk HX 


mButton1 = (Button) fndViewById(R.id.myButton1l); 

mTextViewl = (TextView) find ViewByld(R.id.myTextView 1); 
mImageView1 = (ImageView) find ViewByld(R.id.mylmageView 1); 
mButton1.setOnClickListener(new Button.OnClickListener() 


1 
@Override 
public void onClick(View arg0) 
1 


/* 在 ImageView 中 设置 Bitmap */ 


mlmageViewl .setImageBitmap(getURLBitmap()); 


mTextViewl.setText(""); 
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public Bitmap getURLBitmap() 


1 


URL imageUrl = null; 
Bitmap bitmap = null; 
try 
1 
/* new URL 对 象 将 网 址 传 入 */ 
imageUrl = new URL(uriPic); 
} 
catch (MalformedURLException e) 
t 
e.printStackTrace(); 
} 
Try 


1 


F tu.java 的 
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P DEE */ 
HttpURLConnection conn = (HttpURLConnection) imageUrl 


.openConnection(); 


conn.connect(); 
/* 取得 返回 的 InputStream */ 
InputStream is = conn.getInputStream(); 
/* 将 InputStream 变 成 Bitmap */ 
bitmap = BitmapFactory.decodeStream(is); 
/* 关闭 InputStream */ 
is.close(); 

} 

catch (IOException e) 

{ 
e.printStackTrace(); 

} 

return bitmap; 

} 
} 


执行 本 实例 代码 ， 单 击 “ 单 击 后 获取 网 络 上 的 图 片 ” 按 钮 后 会 显示 指定 网 址 的 图 片 ， 如 
图 3-3 所 示 。 


单 击 后 获取 网 络 上 的 图 片 


图 3-3 ”执行 效果 


3.2 Android 网 络 接口 


在 Android 系统 中 ， 可 以 使 用 网 络 接口 android.nethttp 来 处 理 网 络 中 的 HTTP 请求 。 在 
Android 应 用 程序 中 ，android.net.http 是 android.net 中 的 一 个 典型 包 ， 在 里 面 主要 包含 了 处 理 
SSL 证 书 的 各 种 类 。 在 本 节 的 内 容 中 ， 将 详细 讲解 Android 网 络 接口 的 基本 知识 。 
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3.2.1 android.net.http 中 的 类 


在 Android API 接口 中 ，android.net.http 里 面 存 在 如 下 的 4 个 类 。 


LI AndroidHttpClient. 
LJ SslCertificate. 

QO) SslCertificate.DName. 
LI SslError. 


Apache DefaultHttpClient 面向 Android 系统 了 


上 述 各 个 类 的 具体 说 明 如 表 3-1 所 示 。 


表 3-1 android.net.http 中 的 类 


[发 的 具有 合理 的 默认 配置 以 及 注册 框架 的 类 ， 同 样 允 许 


AndroidHtipChent 户 添加 HttpRequestInterceptor 类 
HttpResponseCache 将 HTTP 和 HTTPS 的 响应 连接 缓存 到 文件 系统 ， 这 样 当 被 再 次 使 用 时 可 以 节省 时 间 和 带宽 
SslCertificate 实现 SSL《〈 密 套 接 字 协议 层 ) 认证 信息 (认证 细节 ) 的 类 


SslCertificate.DName 专用 


名 字 帮 助 类 ;一 个 三 元 组 包括 域名 CCN) 、 


组 织 结构 (O) 、 次 级 组 织 结构 COU) 


SslError 


表示 了 一 组 一 个 或 多 SSL 错误 和 与 它们 相关 联 的 SSL 证 书 


在 Android 应 用 程序 中 , “android.net* ”是 通过 对 Apache 的 HttpClient 封装 来 实现 HTTP 


编程 接 


功能 的 。 并 且 同 时 还 提供 了 HTTP 请 求 队列 管理 
并 发 请 求情 况 下 (如 转载 网 页 时 ) 的 处 理 效率 ， 除 此 之 外 还 有 网 


3.2.2 ”实战 演练 一 一 在 手机 屏幕 中 传递 HTTP 参数 


HTTP 是 一 种 
形式 实现 数据 显示 


节 的 内 容 中 ， 将 


个 具体 实例 来 i 


E, UK HTTP 连接 池 管 理 ， 以 提高 


络 状态 监视 等 功能 接口 。 


HE 型 的 网 络 传输 协议 ， 现 实 中 的 大 多 数 网 页 都 是 通过 “HTTP:W/WWW.” 的 
的 。 在 具体 应 用 时 ， 一 些 重 要 的 HTTP 数据 都 是 通过 其 参数 传递 的 。 在 本 
解 在 手机 屏幕 中 传递 HTTP 参数 的 流程 。 


功 


ae 
He 


源码 路 径 


在 手机 屏幕 中 传递 HTTP 参数 


daima\3\httpSHI 


1. 实现 思路 


在 计算 机 网 络 技术 中 ， 和 HTTP 有 关 的 网 络 协议 是 HTTP protocol。 在 Android SDK 中 内 


置 了 Apache 的 HttpClient 模块 ， 


2. 具体 实现 


C1) 编写 布局 文件 main.xml， 


通过 这 些 模 块 可 以 方便 地 编写 出 和 HTTP 有 关 的 应 
在 本 实例 中 首先 建立 了 和 HTTP 的 连接 代码 ， 


只 有 在 连接 之 后 才 


果 。 然 后 插入 了 两 个 按钮 ， 一 个 
获取 数据 ， 并 以 TextView 对 象 来 


HLA POST 方式 获取 网 站 数据 ， 


HR, 
能 获取 Web Server 返回 的 结 
另外 一 个 用 于 以 GET 方式 


主要 代码 如 下 。 


| 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:background="(@drawable/white" 


显示 由 服务 器 端 返回 的 网 页 内 容 来 显示 连接 结果 。 
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android:orientation="Vertical" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent"> 
<TextView 
android:id="@-+id/myTextView1" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/title"/> 
<Button 
android:id="@-+id/myButton 1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/str_button1" /> 
<Button 
android:id="@-+id/myButton2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/str_button2" /> 
</LinearLayout> 


(2) 编写 文件 httpSHILjava， 其 具体 实现 流程 如 下 。 
O 引用 apache.http 中 的 相关 类 来 实现 HTTP 联机 操作 ,然后 引用 java.io 和 java.util 相关 
类 来 读 写 信息 。 有 具体 代码 如 下 。 


人 # 引 用 apache.http 相关 类 来 建立 HTTP 联机 */ 
import org.apache.http.HttpResponse; 


import org.apache.http.NameValuePair; 
import org.apache.http.client.ClientProtocolException; 
import org.apache.http.client.entity. UrlEncodedFormEntity; 
import org.apache.http.client.methods.HttpGet; 
import org.apache.http.client.methods.HttpPost; 
import org.apache.http.impl.client.DefaultHttpClient; 
import org.apache.http.message.BasicName ValuePair; 
import org.apache.http.protocol.HTTP; 
import org.apache.http.util.EntityUtils; 
/* hits S/F java.io 与 java.util 相关 类 来 读 写 档 案 */ 
import irdc.httpSHI.R; 
import java.io. IOException; 
import java.util. ArrayList; 
import java.util.List; 
import java.util. regex.Matcher; 
import java.util. regex.Pattern; 
import android.app.Activity; 
import android.os.Bundle; 
import android.view. View; 
import android.widget.Button; 
import android.widget.TextView; 
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O 使 用 OnClickListener 方法 监听 单 击 后 的 第 一 个 按钮 事件 ， 声 明 网 址 字符 串 并 以 POST 
方式 建立 联机 ， 最 后 通过 mTextViewl.setText 方法 输出 提示 字符 。 有 具体 代码 如 下 。 


/* dk OnClickListener 方法 来 聆听 OnClick 事件 */ 
mButton1.setOnClickListener(new Button.OnClickListener() 
{ 
#5 onClick 事件 */ 
@Override 
public void onClick(View v) 
{ 
放声 明 网 址 字符 串 */ 
String uriAPI = "http://www.dubblogs.cc:8751/Android/Test/API/Post/index.php"; 


人 # 建 立 HTTP POST 联机 */ 
HttpPost httpRequest = new HttpPost(uriA PI); 
/* 
* POST 运行 传送 变量 必须 用 NameValuePair[] 数 组 存储 
20 


List <NameValuePair> params = new ArrayList <NameValuePair>(); 
params.add(new BasicNameValuePair("str", "I am Post String")); 
try 
1 
httpRequest.setEntity(new UrlEncodedFormEntity(params, HTTP.UTF 8)); 
Pfs HTTP 输出 */ 
HttpResponse httpResponse = new DefaultHttpClient().execute(httpRequest); 
e An WE 200 */ 
if(httpResponse.getStatusLine().getStatusCode()- — 200) 
1 
PIE) 
String strResult = EntityUtils.toString(httpResponse.getEntity()); 
mTextView1 .setText(strResult); 
} 
else 
{ 
mTextView1.setText("Error Response: "--httpResponse.getStatusLine().toString()); 
j 
j 


catch (ClientProtocolException e) 


1 


mTextViewl.setText(e.getMessage().toString()); 


e.printStackTrace(); 


} 
catch (IOException e) 


{ 
mTextViewl.setText(e.getMessage().toString()); 
e.printStackTrace(); 


j 
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catch (Exception e) 


j 


DI 


{ 


j 


mTextViewl.setText(e.getMessage().toString()); 
e.printStackTrace(); 


nth 
"ar 


Se 


方式 的 联机 功能 ， 然 后 分 别 实现 发 出 HTTP 获取 请 求 、 获 取 应 答 字符 串 和 删除 匈 


符 操 作 ， 最 后 通过 mTextViewl.setText 方法 输出 提示 字符 。 具 体 代码 如 下 。 


pun 


mButton2.setOnClickListener(new Button.OnClickListener() 


1 


@Override 
public void onClick(View v) 


1 


// TODO Auto-generated method stub 

/* BEES ST Rn 

String uriAPI = "http://www.XXXX.cc:8751/index.php?str-I-am-*Get* String"; 
/*£& vr. HTTP GET 联机 */ 

HttpGet httpRequest = new HttpGet(uriAPD; 

try 


1 


j 


/* Beth HTTP 获取 请 求 */ 
HttpResponse httpResponse = new DefaultHttpClient().execute(httpRequest); 
PARAS 200 ok*/ 
if(httpResponse.getStatusLine().getStatusCode()- — 200) 
1 
PREY EEA RM 
String strResult = EntityUtils.toString(httpResponse.getEntity()); 
PUN ERICA e rat 
strResult = eregi_replace("(\r\n|\r\n|\n\r)","",strResult); 
mTextView1.setText(strResult); 
} 
else 
1 


mTextView1.setText("Error Response: "--httpResponse.getStatusLine().toString()); 


catch (ClientProtocolException e) 


1 


mTextViewl.setText(e.getMessage().toString()); 
e.printStackTrace(); 
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} 

catch (IOException e) 

{ 
mTextView1.setText(e.getMessage().toString()); 
e.printStackTrace(); 

} 

catch (Exception e) 

1 
mTextViewl.setText(e.getMessage().toString()); 
e.printStackTrace(); 


O 定义 替换 字符 串 函数 eregi_replace 来 替换 掉 一 些 非法 字符 ， 有 具体 代码 如 下 。 


I* 字符 串 替 换 函 数 */ 
public String eregi_replace(String strFrom, String strTo, String strTarget) 
1 

String strPattern = "(?i)"+strFrom; 

Pattern p — Pattern.compile(strPattern); 

Matcher m = p.matcher(strTarget); 

if(m.find()) 

{ 

return strTarget.replaceAll(strFrom, strTo); 
} 


else 


1 


return strTarget; 


j 


(3) 在 文件 AndroidManifest.xml 中 声明 网 络 连接 权限 ， 有 具体 代码 如 下 。 


<uses-permission android:name="android.permission.INTERNET"></uses-permission> 


执行 后 的 效果 如 图 3-4 所 示 ， 单 击 屏幕 中 的 按钮 能 够 以 不 同 的 方式 获取 HTTP 参数 。 


使 用 POST 方式 


使 用 GET 方 式 


图 3-4 单 击 “ 使 用 PSST 方式 ”按钮 后 的 效果 
EN 71 


. Android 网 络 开 发 从 入 门 到 精通 
在 Android 系统 中 打开 链接 的 通用 代码 如 下 。 


Intent it = new Intent(Intent. ACTION VIEW, Uri.parse("http://www.baidu.com")); 
it.setClassName("com.Android.browser", "com.android.browser.BrowserActivity"); 
getContext().startActivity(1t); 


在 Android 系统 中 打开 本 地 网 页 的 通用 代码 如 下 。 


Intent intent=new Intent(); 

intent.setAction("android.intent.action. VIEW"); 

Uri CONTENT URI BROWSERS = Uri.parse("content://com.android.htmlfileprovider/sdcard/123.html"); 
intent.setData(CONTENT URI BROWSERS); 

intent.setClassName("com.android.browser", "com.android.browser.BrowserActivity"); 
startActivity (intent); 
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oF, 4 


下 载 是 指 通过 网 络 进行 传输 文件 ， 把 互联 网 或 
算 机 上 的 一 种 网 络 活动 。 下 载 可 以 显 式 或 隐 式 地 进行 , 只 要 是 获得 本 地 计算 机 上 所 没有 的 信 
上 传 ” 的 反义词 是 “下 载 ” 上 传 就 是 将 信息 
上 的 人 都 能 看 到 。 将 制作 好 
次 赏 。 这 一 过 程 称 为 上 传 。 


Hitch, ët 


从 本 地 计算 机 传递 到 
的 网 页 、 文 字 


可 以 认为 是 下 载 ， 如 在 线 观 看 。” | 
央 计 算 机 (远程 计算 机 〉 系统 上 ， 让 网 络 | 


片 等 发 布 到 互联 网 ， 以 便 让 其 他 人 浏览 、 


、 图 


Android 网 络 开发 中 ， 下 载 和 .| 
Android 手机 中 实现 远程 下 载 、 


基础 。 


4.1 


在 Android 系统 应 用 


ar. 


Hi 


Een DR JE AK A 


出 现 应 用 程序 无 响应 的 情况 。 对 于 这 种 情况 ， 
的 操作 。 在 Android 网 络 应 用 中 
CD 直接 获取 ， 演 示人 代码 如 下 。 


下 载 、 上 传 数据 


下 载 网 络 中 的 图 片 数 据 


中 ， 获 取 网 络 中 的 


般 的 解决 方法 就 是 使 
有 如 下 三 种 获取 网 络 图 片 的 方法 。 


他 电子 计算 机 上 的 信息 保存 到 本 地 计 


在 


上 传 是 两 个 十 分 常见 的 操作 。 在 本 章 的 内 容 中 ， 将 详细 讲解 在 
上 识 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打 下 


图 片 是 一 件 耗 时 的 操作 ， 如 果 直接 获取 有 可 能 会 


和 线程 来 实现 比较 耗 时 


mImage View = (ImageView)this.findViewByld(R.id.imageThreadConcept) ; 
Drawable drawable = loadImageFromNetwork(IMAGE URL); 
mImageView.setImageDrawable(drawable) ; 


对 应 的 公 


用 方法 的 实现 代码 如 下 。 


private Drawable loadImageFromNetwork(String imageUrl) 


1 


Drawable drawable — null; 


try { 


/ 可 以 在 这 里 通过 文件 名 来 


drawable = Drawable.createFromStream( 


天 新， 是 否 本 地 有 此 图 片 


new URL(imageUrl).openStream(), "image.jpg"); 


} catch (IOException e) 1 


Log.d("test", e.getMessage()); 


} 


if (drawable == null) { 
Log.d("test", "null drawable"); 


} else { 


Log.d("test", "not null drawable"); 
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j 


return drawable ; 


j 
(2) 后 台 线 程 获取 URL 图 片 ， 演 示 代 码 如 下 。 


mImage View = (ImageView)this.findViewByld(R.id.imageThreadConcept) ; 
new Thread(new Runnable(){ 
Drawable drawable = loadImageFromNetwork(IMAGE URL); 
@Override 
public void run() { 


// post) 用 于 到 UI 主线 程 中 更 新 图 片 
mImageView.post(new Runnable() { 
@Override 
public void run() { 
// TODO Auto-generated method stub 
mlmageView.setImageDrawable(drawable) ; 
Ds 
} 


}).start) ; 


(3) AsyncTask 获取 URL 图 片 ， 演 示人 代码 如 下 。 


mImageView = (ImageView)this.findViewById(R.id.imageThreadConcept) ; 
new DownloadlImageTask().execute(|IMAGE URL); 
private class DownloadImageTask extends AsyncTask<String, Void, Drawable> 


1 
protected Drawable doInBackground(String... urls) { 
return loadImageFromNetwork(urls[0]); 
} 
protected void onPostExecute(Drawable result) { 
mImageView.setImageDrawable(result); 
} 
} 


在 接 下 来 的 内 容 中 ， 将 通过 一 个 具体 实例 的 实现 过 程 ， 来 讲解 在 Android 手机 中 下 载 远 
程 网 络 图 片 的 方法 。 


是 Hd 源码 路 径 
m 在 Android FØLE Fach P HE daima M GetAPicture 


本 实例 的 具体 实现 流程 如 下 。 
C1) 在 布局 文件 main.xml 中 设置 一 个 网 址 文本 框 ， 主 要 代码 如 下 。 
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<EditText 
android:layout_width="fill_parent" 

android:layout height-"wrap content" 

android:text="http://xxxx.jpg" 

android:id="(@+id/path" 

/> 


H 


在 上 述 代码 中 ，http:/xxxx.jpg 是 网 络 中 一 副 图 片 的 地 址 。 
(2) 编写 主 程序 文件 GetAPictureFromInternetActivityjava， 主 要 实现 代码 如 下 。 


public class GetAPictureFromInternetActivity extends Activity { 
private EditText pathText; 
private Image View imageView; 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContent View(R.layout.main); 
pathText = (EditText) this.findViewByld(R.id.path); 
imageView = (Image View) this.findViewById(R.id.imageView); 
} 
public void showimage(View v)1 
String path = pathText.getText().toString(); 
try { 
Bitmap bitmap = ImageService.getImage(path); 
image View.setImageBitmap(bitmap); 
} catch (Exception e) { 
e.printStackTrace(); 
Toast.makeText(getA pplicationContext(), R.string.error, 1).show(); 


j 
执行 后 的 效果 如 图 4-1 所 示 。 


http://img10.360buyimg.com/book1/s75x75_g14/ 
MOA/06/09/ 
rBEhVVHpYGslAAAAAABAHtBqO9gAABOSAOX8XEAAHq2 


335.jpg 


图 4-1 执行 效果 


4.2 “下载 网 络 中 的 JSON 数据 


JavaScript 对 象 表示 法 (JavaScript Object Notation，JSON )， 是 一 种 轻 量 级 的 数据 交换 格 


式 。JSON 是 JavaScript (Standard ECMA-262 3rd Edition - December 1999) 的 一 个 子 集 ， 采 用 
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完全 独立 于 语言 的 文本 格式 ， 但 是 也 使 用 了 类 似 于 C 语言 家 族 的 习惯 


Java, JavaScript. Perl. Python 等 )。 易 于 阅读 和 


包括 C、C++、C#、 


编写 ， 同 时 也 易于 解析 和 生成 ， 这 些 特性 使 


JSON 成 为 理想 的 数据 交换 语言 。 在 本 节 的 内 容 中 ， 将 详细 讲解 在 Android 系统 中 获取 JSON 


数据 的 基本 知识 。 
4.24 JSON 基础 


简单 来 说 ，JSON 是 JavaScript 中 的 对 象 和 数组 ， 所 以 就 是 对 象 和 数组 这 两 种 结构 ， 通 过 
这 两 种 结构 可 以 表示 各 种 复杂 的 结构 。 


CD WR 


对 象 在 ISON 中 表示 为 “人 f}” 括 起 来 的 内 容 ， 数 据 结构 为 {key: valuekey: value,...} 的 


键 值 对 的 结构 ， 在 面向 对 象 的 


语言 中 ，key 为 对 象 的 属性 ，value 为 对 应 


的 属性 值 ， 所 以 很 容 


易 理 解 ， 取 值 方法 为 对 象 .key 获取 属性 值 ， 这 个 属性 值 的 类 型 可 以 是 数字 、 字 符 串 、 数 组 、 


对 象 几 种 。 

(2) 数组 

数组 在 JSON 中 是 中 括号 
取 值 方式 和 所 有 语言 


“[]” 插 起 来 的 内 容 ， 数 据 结构 为 ["java","javascript","vb",.…]， 


HH (String)、 数 组 、 对 象 (Object) 几 种 。 
经 过 对 象 、 数 组 这 两 种 结构 就 可 以 组 合成 复杂 的 数据 结构 。 


的 Object。 


用 JSON 表示 String. Number 和 Boolean 的 方法 非常 简单 ， 例 如 月 


样 ， 使 用 索引 获取 ， 字 段 值 的 类 型 可 以 是 数字 (Number)、 字 符 


和 XML 一 样 ，JSON 也 是 基于 纯 文 本 的 数据 格式 。JSON 的 数据 格式 非常 简单 ， 可 以 


] JSON 传输 一 个 简单 的 String、Number、Boolean， 也 可 以 传输 一 个 数组 ， 或 者 一 个 复杂 


单 的 String 数据 “abc”， 则 其 表示 格式 为 : 


"abc" 


除了 字符 mmy A”, 0" anregen 


符 可 以 直接 输出 。 一 个 完整 的 String 表示 结构 ， 如 图 4-2 所 示 。 
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string 


@ quotation mark 


reverse solidus 


carriage return 


(5) 
©) 
© horizontal tab 


| 


Lok 4 hexadecimal digits 


图 4-2 ”完整 的 String 表示 结构 


H JSON 表示 一 个 简 


Hf Ob, V, Ws, V, NO 需要 编码 外 ， 其 他 Unicode 字 


SAS 下 载 、 上 传 数据 


4.2.2 ”远程 下 载 服务 器 中 的 JSON 数据 


在 接 下 来 的 内 容 中 ， 将 通过 一 个 具体 实例 的 实现 过 程 ， 来 详细 讲解 在 Android 系统 中 远 


程 下 载 服务 器 ， 


的 JSON 数据 的 方法 。 


题 


H 的 源码 路 径 


实例 


4-2 在 手机 屏幕 中 显示 QQ 空间 中 的 照片 daima\4\json 


本 实例 的 具体 实现 流程 如 下 。 


(1) 使 用 Eclipse 新 建 一 个 JavaEE 工程 作为 服务 器 端 ， 设 置 工程 名 为 “ServerForJSON”。 
自动 生成 工程 文件 后 ， 打 开 文 件 web.xml 进行 配置 ， 配 置 后 的 代码 如 下 。 


<?xml version="1.0" encoding="UTF-8"?> 
<web-app id="WebApp_ID" version="2.4" xmlns-"http://Java.sun.com/xml/ns/j2ee" xmlns:xsi-"http:// 
www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/ 


xml/ns/j2ee/web-app 2 4.xsd"> 


<display-name>ServerForJSON</display-name> 


<servlet> 


<display-name>NewsListServlet</display-name> 


<servlet-name>NewsListServlet</servlet-name> 


<servlet-class>com.guan.server.xml.NewsListServlet</servlet-class> 
</servlet> 


<servlet-mapping> 


<servlet-name>NewsListServlet</servlet-name> 


<url-pattern>/NewsListServlet</url-pattern> 


</servlet-mapping> 


<welcome-file-list> 


<welcome-file>index.html</welcome-file> 


<welcome-file>index.jsp</welcome-file> 


</welcome-file-list> 


</web-app> 


(2) Fn GLAS 


public interface NewsService { 
[** 
* 获取 最 新 的 视频 资讯 
* @return 
«i 
public List<News> getLastNews(); 


j 


Bean 的 实现 文件 NewsService.java, HA Fr. 


设置 业务 Bean 的 名 称 为 NewsServiceBean， 实 现 文件 NewsServiceBean java 的 具体 代码 


如 下 。 
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(3) 创建 一 个 名 为 “News” 的 实现 类 ， 实 现 文件 News.java DI 
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package com.guan.server.service.implement; 


import java.util. Array List; 


import java.util List; 


import com.guan.server.domain.News; 


import com.guan.server.service.NewsService; 


public class NewsServiceBean implements NewsService { 


j 


[** 
* 获取 最 新 的 视频 资讯 
* (Oreturn 
public List<News> getLastNews() { 
List<News> newes = new ArrayList<News>(); 
newes.add(new News(10, "aaa", 20)); 
newes.add(new News(45, "bbb", 10)); 
newes.add(new News(89, "Android is good", 50)); 


return newes; 


package com.guan.server.domain; 


public class News { 


private Integer id; 

private String title; 

private Integer timelength; 

public News(Integer id, String title, Integer timelength) { 
this.id = id; 
this.title = title; 
this.timelength = timelength; 

} 

public Integer getId() { 
return id; 

} 

public void setId(Integer id) { 
this.id = id; 

} 

public String getTitle() { 
return title; 

} 

public void setTitle(String title) { 
this.title = title; 

} 

public Integer getTimelength() { 
return timelength; 

} 


public void setTimelength(Integer timelength) { 


具体 代码 如 下 。 


第 4 章 下 载 、 上传 数 据 | 


this.timelength = timelength; 


j 


(4) 编写 文件 NewsListServlet， 具 体 实现 代码 如 下 。 


public class NewsListServlet extends HttpServlet { 
private static final long serial VersionUID = 1L; 
private NewsService newsService = new NewsServiceBean(); 
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws 
ServletException, IOException { 
doPost(request, response); 
} 
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws 
ServletException, IOException { 
List<News> newes = newsService.getLastNews();// 获 取 最 新 的 视频 资讯 
/| — [{id:20,title:"xxx",timelength:90}, {id:10,title:"xbx",timelength:20}] 
StringBuilder json = new StringBuilder(); 


json.append('[); 

for(News news ` newes) { 
json.append( (^); 
json.append("id:").append(news.getId()).append(","); 
json.append("title:\"").append(news.getTitle()).append("\"""); 
json.append("timelength:").append(news.getTimelength()); 
json.append("},"); 

j 

json.deleteCharAt(json.length() - 1); 

json.append(']); 

request.setAttribute("json", json.toString()); 

request.getRequestDispatcher("/WEB-INF/page/jsonnewslist.jsp").forward(request, response); 


j 


C5) 新 建 一 个 JSP 文件 jsonnewslistjsp， 并 引入 JSON 功能 ， 有 具体 实现 代码 如 下 。 


<%@ page language="java" contentType="text/plain; charset-UTF-8" pageEncoding="UTF-8"%>$ {json} 


Tur 


(6) 使 用 Eclipse 新 建 一 个 名 为 “GetNewsInJSONFromInternet” 的 Android 工程 文件 ， 在 
文件 AndroidManifest.xml 中 申明 对 网 络 权 限 的 应 用 ， 有 具体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.guan.internet.json" 
android:versionCode="1" 
android:versionName="1.0"> 
«application android:icon="(@drawable/icon" android:label="@string/app_name"> 


«activity android:name="com.guan.internet.json.MainActivity" 
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android:label="@string/app_name"> 
<intent-filter> 
«action android:name="android. intent.action. MAIN" /> 
«category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
<uses-sdk android:minSdkVersion-"8" /> 
<!-- 访问 internet 权限 — 
<uses-permission android:name="android.permission.INTERNET"/> 


</manifest> 


(7) 编写 主 界面 布局 文件 mian.xml， 具 体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="Vertical" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
> 

<ListView 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:id="@-+id/listView" 
> 


</LinearLayout> 


DL 


在 上 述 代 码 中 , 通过 ListView 控件 列表 显示 获取 的 ISON 数据 。 其 中 ListView 的 Item 显 
示 的 数据 为 item.xml， 具 体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="fill_parent" 
android:layout_height=" 

<TextView 


android:layout_width="200dp" 


wrap_content"> 


android:layout_height 
android:id="@+id/title" 
(Em 


wrap content" 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:id="@-+id/timelength" 
[^ 


</LinearLayout> 


KOR E 


SAS 下 载 、 上 传 数据 
(8) 编写 文件 MainActivityjava, 功能 是 获取 ISON 数据 并 显示 数据 ,有 具体 实现 代码 如 下 。 


public class MainActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
ListView listView = (ListView) this.findViewById(R.1id.list View); 
String length — this.getResources().getString(R.string.length); 
try { 
List<News> newes = NewsService.getJSONLastNews(); 
List<HashMap<String, Object>> data = new ArrayList<HashMap<String, Object>>(); 
for(News news : newes){ 
HashMap<String, Object» item = new HashMap<String, Object>(); 
item.put("id", news.getId()); 
item.put("title", news.getTitle()); 
item.put("timelength", length+ news.getTimelength()); 
data.add(item); 
j 
SimpleAdapter adapter = new SimpleAdapter(this, data, R.layout.item, 
new String[] "title", "timelength"}, new int[] (R.1d.title, R.id.timelength} ); 
listView.setAdapter(adapter); 
} catch (Exception e) 1 
e.printStackTrace(); 


j 
(9) 编写 文件 NewsService.java, 4E X77 14 geUSONLastNews0 请 求 前 面 搭 建 的 JavaEE 服 
务 器 , 当 获取 ISON 输入 流 后 解析 ISON 的 数据 , 并 返回 集合 中 的 数据 。 文件 NewsService.java 
的 具体 实现 代码 如 下 。 


public class NewsService { 
[** 


* 获取 最 新 视频 资讯 
* @return 
* @throws Exception 
St 
public static List<News> getJSONLastNews() throws Exception { 
String path = "http://192.165.1.100:8080/ServerForJSON/NewsListServlet"; 
Http URLConnection conn = (HttpURLConnection) new URL(path).openConnection(); 
conn.setConnectTimeout(5000); 
conn.setRequestMethod("GET"); 
if(conn.getResponseCode()== 200) { 
InputStream json = conn.getInputStream(); 
return parseJSON(json); 
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} 


return null; 
} 
private static List<News> parseJSON(InputStream jsonStream) throws Exception { 
List<News> list = new ArrayList<News>(); 
byte[] data = StreamTool.read(jsonStream); 
String json = new String(data); 
JSONArray jsonArray = new JSONArray(json); 
for(int i = 0; i < jsonArray.length() ; i++){ 
JSONObject jsonObject = jsonArray.getJSONObject(i); 
int id = jsonObject.getInt("id"); 
String title = jsonObject.getString("title"); 
int timelength = jsonObject.getInt("timelength"); 
list.add(new News(id, title, timelength)); 


j 


return list; 


j 
到 此 为 止 ， 整 个 实例 介绍 完毕 ， 执 行 后 将 成 功 获 取 服 务 器 站 ISON 的 数据 。 


4.3 下 载 某 个 网 页 的 源码 


"^E Android 系统 中 加 载 非 本 地 的 HTML 文件 时 ， 会 对 此 HTML 进行 缓存 操作 ， 同 时 会 建 
一 个 数据 库 ， 用 以 保存 URL 地 址 对 应 的 缓存 文件 名 称 、 打 开 时 间 等 信息 。 我 们 可 以 将 Web View 
加 载 的 URL 地 址 作为 查询 条 件 以 获取 对 应 的 缓存 文件 名 称 ， 匹 配 出 的 缓存 文件 就 是 完整 的 
HTML 代码 。 


题 H HE W 源码 路 径 
实例 4-3 在 手机 屏幕 中 显示 QQ 空间 中 的 照片 daima\4\WebCodeViewer 


本 实例 的 具体 实现 流程 如 下 。 
C1) 编写 界面 布局 文件 main.xml， 有 具体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 
«TextView 
android:layout width-"fill parent" 


android:layout height-"wrap content" 
android:text-"(a)string/path" 
[^ 


<EditText 
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android:layout width-"fill parent" 


android:layout height-"wrap content" 
android:text="http://www.baidu.com" 
android:id="(@+1id/path" 

[^ 

«Button 


android:layout width 


wrap content" 
android:layout height-"wrap content" 
android:text="@string/button" 
android:onClick="showhtml" 
/> 
<Scroll View 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
> 
<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:id="@-+id/textView" 
[^ 
</Scroll View> 


</LinearLayout> 


(2) 编写 文件 HtmlService.java， 定 义 一 个 获取 网 页 代码 的 业务 类 HtmlService， 主 要 代码 
如 下 。 


public class HtmlService { 
[** 
* 获取 网 页 源码 
* @param path 网 页 路 径 
* (Oreturn 
E 
public static String getHtml(String path) throws Exception 1 
HttpURL Connection conn = (HttpURLConnection)new URL(path).openConnection(); 
conn.setConnectTimeout(5000); 
conn.setRequestMethod(" GET"); 
if(conn.getResponseCode()== 200) { 
InputStream inStream = conn.getInputStream(); 
byte[] data = StreamTool.read(inStream); 
return new String(data); 


j 


return null; 


j 


(3) 编写 文件 StreamTooljava， 功 能 是 将 流转 换 为 字 节 数组 ， 主 要 代码 如 下 。 
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public static byte[] read(InputStream inStream) throws Exception { 
ByteArrayOutputStream outputStream = new ByteArrayOutputStream(); 


j 


(4) 编 


3 CHE WebCodeViewerActivityjava, “44 


指定 网 页 的 源码 。 文 件 WebCodeViewerActivity.java 的 


byte[] buffer = new byte[1024]; 

int len = 0; 

while( (len = inStream.read(buffer)) != -1){ 
outputStream.write(buffer, 0, len); 

j 

inStream.close(); 

return outputStream.toByte Array(); 


t 
EH 


屏幕 中 的 GetWebCode 按钮 时 会 获取 
本 实现 代码 如 下 。 


=> 


public class WebCodeViewerActivity extends Activity { 


} 


private EditText pathText; 

private TextView textView; 

@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


N 


pathText = (EditText) this.find ViewByld(R.id.path); 
text View = (TextView) this.find ViewByld(R.id.textView); 


} 
public void showhtml( View v) { 
String path = pathText.getText().toString(); 


try { 


String html = HtmlService.getHtml(path); 


text View.setText(html); 
} catch (Exception e) { 
e.printStackTrace(); 


Toast.makeText(getA pplicationContext(), R.string.error, Toast. LENGTH_LONG).show(); 


= 一 


执行 后 的 效果 如 图 4-3 所 示 。 
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http://www.baidu.com 


GetWebCode 


图 4-3 ”执行 效果 
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44 多 线程 下 载 


线程 可 以 理解 为 下 载 的 通道 ， 一 个 线程 就 是 一 个 文件 的 下 载 通道 ， 多 线程 也 就 是 同时 开 
局 几 个 下 载 通 道 。 当 服务 器 提供 下 载 服务 时 ， 下 载 者 是 共享 带宽 的 ， 在 优先 级 相同 的 情况 下 ， 
服务 器 会 对 总 下 载 线程 进行 平均 分 配 。 如 果 线 程 越 多 ， 下 载 的 速度 就 会 越 快 。 在 本 节 的 内 容 
中 ， 将 详细 讲解 在 Android 系统 中 实现 多 线程 下 载 的 过 程 。 


441 多 线程 下 载 文件 的 过 程 


在 Android 系统 中 ， 实 现 多 线程 下 载 的 基本 过 程 如 下 。 
C1) 获取 下 载 文件 的 长 度 ， 然 后 设置 本 地 文件 的 长 度 。 


HttpURLConnection.getContentLength();// 获 取 下 载 文 件 的 长 度 
RandomAccessFile file = new RandomAccessFile("QQWubiSetup.exe","rwd"); 
file.setLength(filesize);// 设 置 本 地 文件 的 长 度 
(2) 根据 文件 长 度 和 线程 数目 计算 每 条 线程 下 载 的 数据 长 度 和 下 载 位 置 。 假 如 文件 的 长 
度 为 6MB， 线 程 数 为 3， 那 么 每 条 线程 下 载 的 数据 长 度 为 2MB， 每 条 线程 开始 下 载 的 位 置 如 


下 图 4-4 所 示 。 
ee) --- 
E | 线程 2 | 线程 3 
0 2MB 4MB 
图 4-4 每 条 线程 开始 下 载 的 位 置 
例如 LOMB 大 小 文件 ， 则 使 用 3 个 线程 来 下 载 ， 具 体 说 明 如 下 。 
口 线程 下 载 的 数据 长 度 : 使 用 表达 式 (10%3 ==0 ? 10/3:10/3+1) 进 行 计算 , 其 中 第 1 和 
第 2 个 线程 下 载 长 度 是 4MB， 第 3 个 线程 下 载 长 度 为 2MB。 
口 下 载 开 始 位 置 : 使 用 表达 式 (线程 id* 每 条 线程 下 载 的 数据 长 度 ) 进行 计算 。 
O 下 载 结束 位 置 : 使 用 表达 式 〈( 线 程 id+1) * 每 条 线程 下 载 的 数据 长 度 -1) 进行 计算 。 
(3) 使 用 HTTP 的 Range 头 字 段 指定 每 条 线程 从 文件 的 什么 位 置 开 始 下 载 ， 下 载 到 什么 
立 置 为 止 ， 例 如 指定 从 文件 的 2MB 位 置 开始 下 载 ， 下 载 到 位 置 (4MB-1byte) 为 止 ， 代 码 如 下 。 


HttpURLConnection.setRequestProperty("Range", "bytes=2097152-4194303"); 


(4) 保存 文件 ， 使 用 类 RandomAccessFile 指定 每 条 线程 从 本 地 文件 的 什么 位 置 开 始 写 入 
数据 。 


RandomAccessFile threadfile = new RandomAccessFile("QQWubiSetup.exe ","rwd"); 
threadfile.seek(2097152);// 从 文件 的 什么 位 置 开始 写 入 数据 


44.2 ”在 Android 系统 中 实现 多 线程 下 载 


在 接 下 来 的 实例 中 , 演示 了 在 Android 平台 中 通过 HTTP 协议 实现 断 点 续 传 下 载 的 方法 。 
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本 实例 是 一 个 HTTP 协议 多 线程 断 点 下 载 应 用 程序 ， 直 接 使 用 单线 程 下 载 HTTP 文件 对 初学 
者 来 说 是 一 件 非 常 简 单 的 事 。 多 线程 断 点 需要 具备 如 下 的 功能 。 

O 多 线程 下 载 。 

Q 文 持 断 点 。 


题 H 的 源码 路 径 
实例 4-4 下 载 在 线 铃声 daima\4\Multiple 


本 实例 的 功能 是 在 Android 手机 中 在 线 下 载 铃声 ， 有 具体 实现 流程 如 下 。 


(1) 打开 Eclipse， 新 建 一 个 名 为 “MnultipleThreadDownload” 的 动态 Web 工程 。 然 后 将 
一 个 MP3 文件 保存 在 WebContent 目录 下 ， 最 后 发 布 服务 器 端的 Web 工程 程序 。 

(2) 打开 Eclipse， 新 建 一 个 名 为 “MultipleThreadDownloadrAndroid” 的 Android 工程 。 
然后 编写 主 程序 文件 main.xml， 具 体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


> 
-L- 下 载 路 径 提示 文字 > 
<TextView 


android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:text="@string/path" 

[7 


<!-- 下 载 路 径 输 入 框 ， 此 处 为 了 方便 测试 ， 我 们 设置 了 默认 的 路 径 ， 可 以 根据 需要 在 用 户 界 


处 修改 --> 


E 


«EditText 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="http://192.164.1.100:8080/ServerForMultipleThreadDownloader/ 
CNNRecordingFromWangjialin.mp3" 
android:id="(@+id/path" 


[^ 
<!-- ACH LinearLayout 布局 ， 包 应 下 载 按钮 和 暂停 按钮 — 
<LinearLayout 


android:orientation="horizontal" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 


> 
<!-- 下 载 按钮 ， 用 于 触发 下 载 事件 -> 
<Button 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
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android:text="@string/button" 
android:id="(@+id/downloadbutton" 


[^ 
<!-- 暂停 按钮 ， 在 初始 状态 下 为 不 可 用 — 
<Button 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/stopbutton" 
android:enabled="false" 


android:id="@-+id/stopbutton" 


[^ 
</LinearLayout> 
<!-- 水 平 进度 条 ， 用 图 形 化 的 方式 实时 显示 进步 信息 --> 
<ProgressBar 


android:layout width-"fill parent" 
android:layout_height="18dp" 
style="android:attr/progressBarStyleHorizontal" 
android:id="(@+id/progressBar" 


[^ 
<!-- 文本 框 ， 用 于 显示 实时 下 载 的 百分比 --> 
<TextView 


android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:gravity="center" 
android:id="@+id/result View" 

[^ 


</LinearLayout> 


《3) 创 建 数据 库 管理 类 DBOpenHelper, 实现 文件 DBOpenHelper.java 的 具体 代码 如 下 。 


* 
* SQLite 管理 器 ， 实 现 创 建 数据 库 和 表 ， 但 版 本 变化 时 实现 对 表 的 数据 库 表 的 操作 
*/ 
public class DBOpenHelper extends SQLiteOpenHelper { 
private static final String DBNAME = "eric.db"; /设置 数据 库 的 名 称 
private static final int VERSION = 1; /设置 数据 库 的 版 本 
[** 


* 通过 构造 方法 
* @param context 应 用 程序 的 上 下 文 对 象 
public DBOpenHelper(Context context) { 
super(context, DBNAME, null, VERSION); 


} 
@Override 
public void onCreate(SQLiteDatabase db) { // 建 立 数据 表 
db.execSQL("CREATE TABLE IF NOT EXISTS filedownlog (id integer primary key 
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autoincrement, downpath varchar(100), threadid INTEGER, downlength INTEGER)"); 
j 
@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
// 当 版 本 变化 时 系统 会 调用 该 回调 方法 
db.execSQL("DROP TABLE IF EXISTS filedownlog"); 
/此 处 是 删除 数据 表 ， 在 实际 的 业务 中 一 般 是 需要 数据 备份 的 
onCreate(db); 
// 调 用 onCreate 方法 重新 创建 数据 表 ， 也 可 以 自己 根据 业务 需要 创建 新 的 的 数据 表 


} 
} 
(4) 建立 数据 库 业 务 操作 类 FileService， 此 类 的 实现 文件 是 FileServicejava， 有 具体 代码 如 
v. 
[** 
* 业务 Bean， 实 现 对 数据 的 操作 
= 
public class FileService { 
private DBOpenHelper openHelper; /声明 数据 库 管 理 器 


public FileService(Context context) { 
openHelper = new DBOpenHelper(context); 。 // 根 据 上 下 文 对 象 实例 化 数据 库 管 理 名 


T 


ya 


} 
[** 
* 获取 特定 URI 的 每 条 线程 已 经 下 载 的 文件 长 度 
* @param path 
* @return 
e 
public Map<Integer, Integer> getData(String path) { 
SQLiteDatabase db = openHelper.getReadableDatabase(); 
/获取 可 读 的 数据 库 名 柄 ， 一 般 情况 下 在 该 操作 的 内 部 实现 中 其 返回 的 其 实 是 可 写 的 数据 库 句柄 
Cursor cursor = db.rawQuery("select threadid, downlength from filedownlog where 
downpath=?", new String[] (path]); /根据 下 载 路 径 查 询 所 有 线程 下 载 数 据 ， 返 回 的 Cursor 指向 第 一 条 记录 之 前 
Map<Integer, Integer data = new HashMap<Integer, Integer>(); /建立 一 个 哈 希 表 用 于 存 
放 每 条 线程 的 已 经 下 载 的 文件 长 度 
while(cursor.moveToNext()) { /从 第 一 条 记录 开始 开始 遍历 Cursor 对 象 
data.put(cursor.getInt(0), cursor.getInt(1)); 
/把 线程 id 和 该 线程 已 下 载 的 长 度 设置 进 data 哈 希 表 中 
data.put(cursor. getInt(cursor. getColumnIndexOrThrow("threadid")), cursor.getInt 
(cursor.getColumnIndexOrThrow("downlength"))); 


j 

cursor.close(); /关闭 cursor， 释 放 资 源 

db.close(); /关闭 数据 库 

return data; /返回 获得 的 每 条 线程 和 每 条 线程 的 下 载 长 度 
} 
[** 


* 保存 每 条 线程 已 经 下 载 的 文件 长 度 
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* @param path 下 载 的 路 径 
* @param map 现在 的 id 和 已 经 下 载 的 长 度 的 集合 
Sei 
public void save(String path, Map<Integer, Integer» map) { 
SQLiteDatabase db = openHelper.getWritableDatabase(); /获取 可 写 的 数据 库 句 柄 
db.beginTransaction(); /开始 事务 ， 因 为 此 处 要 插入 多 批 数据 
try{ 
for(Map.Entry<Integer, Integer entry : map.entrySet()) { 
/采用 For-Each 的 方式 遍历 数据 集合 
db.execSQL("insert into filedownlog(downpath, threadid, downlength) values(?,?,?)", 
new Object[] (path, entry.getKey(), entry.getValue()}); 
/插入 特定 下 载 路 径 特定 线程 DD 已 经 下 载 的 数据 


} 
db.setTransactionSuccessful(); /设置 事务 执行 的 标志 为 成 功 

}finally{ // 此 部 分 的 代码 肯定 是 被 执行 的 ， 如 果 不 杀 死 虚 拟 机 的 话 
db.endTransaction(); /结束 一 个 事务 ， 如 果 事 务 设立 了 成 功 标 志 ， 则 提交 事务 ， 


否则 会 滚 事务 


j 
db.close(); /关闭 数据 库 ， 释 放 相 关 资 源 


} 


[** 


* 实时 更 新 每 条 线程 已 经 下 载 的 文件 长 度 
* @param path 


* @param map 
4] 
public void update(String path, int threadId, int pos) { 
SQLiteDatabase db = openHelper.getWritableDatabase(); /获取 可 写 的 数据 库 句 柄 
db.execSQL("update filedownlog set downlength=? where downpath=? and threadid=?", 
new Object[]{pos, path, threadId}); /更 新 特定 下 载 路 径 下 特定 线 
程 已 经 下 载 的 文件 长 度 


db.close(); /关闭 数据 库 ， 释 放 相 关 的 资源 
} 
[** 
* 当 文件 下 载 完 成 后 ， 删 除 对 应 的 下 载 记 录 
* @param path 
e 
public void delete(String path) { 
SQLiteDatabase db = openHelper.getWritableDatabase(); /获取 可 写 的 数据 库 句 柄 
db.execSQL("delete from filedownlog where downpath=?", new Object[] {path}); 
/删除 特定 下 载 路 径 的 所 有 线程 记录 


db.close(); /关闭 数据 库 ， 释 放 资 源 


j 


C5) 编写 文件 下 载 类 FileDownloader, 此 类 调用 类 DownloadThread SCH E 


类 FileDownloader 在 文件 FileDownloader.java 中 定义 ， 具 体 实现 代码 如 下 。 


具体 的 下载 功能 。 
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public class FileDownloader { 


private static final String TAG = "FileDownloader"; /设置 标签 ， 方 便 Logcat 日 志 记录 


private static final int RESPONSEOK = 200; 


private Context context; 
private FileService fileService; 
private boolean exited; 

private int downloadedSize = 0; 
private int fileSize = 0; 


private DownloadThread[] threads; 


private File saveFile; 


/响应 码 为 200， 即 访问 成 功 
/应 用 程序 的 上 下 文 对 象 
/获取 本 地 数据 库 的 业务 Bean 
/停止 下 载 标志 
/已 下 载 文件 长 度 

/原始 文件 长 度 

// 根 据 线程 数 设置 下 载 线程 池 
/数据 保存 到 的 本 地 文件 


private Map<Integer, Integer> data = new ConcurrentHashMap<Integer, Integer>(); 


private int block; 
private String downloadUrl; 


[** 
* 获取 线程 数 
public int getThreadSize() { 
return threads. length; 


j 
/* x 
* 退出 下 载 
i 
public void exit(){ 
this.exited = true; /设置 退出 标志 为 true 
j 


public boolean getExited() { 
return this.exited; 
} 
/ 米 米 
* 获取 文件 大 小 
* (Mreturn 
«n 
public int getFileSize() { 


return fileSize; 
j 
[** 
* 累计 已 下 载 大 小 
* @param size 
in 


/缓存 各 线程 下 载 的 长 度 
/每 条 线程 下 载 的 长 度 
/下 载 路 径 


/根据 数组 长 度 返回 线程 数 


/从 类 成 员 变 量 中 获取 下 载 文件 的 大 小 


protected synchronized void append(int size) { /使 用 同步 关键 字 解 决 并 发 访问 问题 


downloadedSize += size; 


[** 


/把 实时 下 载 的 长 度 加 入 到 总 下 载 长 度 中 
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* 更 新 指定 线程 最 后 下 载 的 位 置 
* @param threadId 线程 id 
* @param pos 最 后 下 载 的 位 置 
f 
protected synchronized void update(int threadId, int pos) { 
this.data.put(threadId, pos); /把 制定 线程 ID 的 线程 赋予 最 新 的 下 载 长 度 , 以 
前 的 值 会 被 覆盖 掉 
this.fileService.update(this.downloadUrl, threadId, pos); /更 新 数据 库 中 指定 线程 的 下 
载 长 度 


} 
[** 
* 构建 文件 下 载 器 
* @param downloadUrl 下 载 路 径 
* @param fileSaveDir 文件 保存 目录 
* @param threadNum 下 载 线程 数 


Si 
public FileDownloader(Context context, String downloadUrl, File fileSaveDir, int threadNum) { 
try { 
this.context = context; /对 上 下 文 对 象 赋值 
this.downloadUrl = downloadUrl; /对 下 载 的 路 径 赋值 


fileService = new FileService(this.context); 


/实例 化 数据 操作 业务 Bean， 此 处 需要 使 用 Context， 因 为 此 处 的 数据 库 是 应 用 程序 私有 


URL url = new URL(this.downloadUrl); // 根 据 下 载 路 径 实 例 化 URL 
if(!fileSaveDir.exists()) fileSaveDir.mkdirs(); // 如 果 指 定 的 文件 不 存在 ， 则 创 


建 目录 , 此 处 可 以 创建 多 层 目 录 
this.threads = new DownloadThread[threadNum]; /根据 下 载 的 线程 数 创建 下 载 
线程 池 
HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 
/建立 一 个 远程 连接 句柄 ， 此 时 尚未 真正 连接 
conn.setConnectTimeout(5*1000); /设置 连接 超时 时 间 为 5 Ab 
conn.setRequestMethod("GET"); /设置 请 求 方式 为 GET 
conn.setRequestProperty("Accept", "image/gif, image/jpeg, image/pjpeg, image/pjpeg, 


application/x-shockwave-flash, application/xaml+xml, application/vnd.ms-xpsdocument, application/x-ms-xbap, 
application/x-ms-application, application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword, */*"); 


bc 


/设置 客户 端 可 以 接受 的 媒体 类 型 
conn.setRequestProperty(" Accept-Language", "zh-CN"); /设置 客户 端 语言 
conn.setRequestProperty("Referer", downloadUrl); 

// 设 置 请 求 的 来 源 页 面 ,便于 服务 端 进行 来 源 统计 
conn.setRequestProperty("Charset", "UTF-8"); /设置 客户 端 编码 
conn.setRequestProperty("User-Agent", "Mozilla/4.0 (compatible; MSIE 4.0; Windows 


NT 5.2; Trident/4.0; .NET CLR 1.1.4322; NET CLR 2.0.50727; .NET CLR 3.0.04506.30; .NET CLR 


3.0.4506.2152; NET CLR 3.30729)"; // 设 置 用 户 代 理 


conn.setRequestProperty("Connection", "Keep-Alive"); /设置 Connection 的 方式 
conn.connect(); /和 远程 资源 建立 真正 的 连接 ， 但 尚 无 返回 的 数据 流 
printResponseHeader(conn); // 答 应 返回 的 HTTP 头 字段 集合 

if (conn.getResponseCode()- -RESPONSEOK) { 
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// 此 处 的 请 求 会 打开 返回 流 并 获取 返回 的 状态 码 , 用 于 检查 是 否 请 求 成 
功 ， 当 返回 码 为 200 时 执行 下 面 的 代码 
this.fileSize = conn.getContentLength();// 根 据 响应 获取 文件 大 小 
if (this.fileSize <= 0) throw new RuntimeException("Unkown file size "); 
// 当 文件 大 小 为 小 于 等 于 零 时 抛 出 运行 时 寞 向 


String filename = getFileName(conn) ;获取 文件 名 称 
this.saveFile = new File(fileSaveDir, filename); /根据 文件 保存 目录 和 文 
件 名 构建 保存 文件 
Map<Integer, Integer> logdata = fileService.getData(downloadUrl); 
/获取 下 载 记录 


iflogdata.size0>0){ ”// 如 果 存 在 下 载 记录 
for(Map.Entry<Integer, Integer> entry : logdata.entrySet()) 
/遍历 集合 中 的 数据 
data.put(entry.getKey(), entry.getValue()); 
// 把 各 条 线程 已 经 下 载 的 数据 长 度 放 入 data 中 


} 
if(this.data.size()==this.threads.length) { 
/如 果 已 经 下 载 的 数据 的 线程 数 和 现在 设置 的 线程 数 相同 时 则 计算 所 
有 线程 已 经 下 载 的 数据 总 长 度 
for (int i = 0; i < this.threads.length; i++) { 
/过 历 每 条 线程 已 经 下 载 的 数据 
this.downloadedSize += this.data.get(i+1); 
/计算 已 经 下 载 的 数据 之 和 


} 
print(" 已 经 下 载 的 长 度 "+ this.downloadedSize + "个 字 节 "); 
/打印 出 已 经 下 载 的 数据 总 和 


us block =  (this.fileSize %  this.threads.length) —-0? this.fileSize / 
this.threads.length : this.fileSize / this.threads.length + 1; /计算 每 条 线程 下 载 的 数据 长 度 
yelse { 
print(" 服 务 器 响应 错误 :" + conn.getResponseCode() + conn.getResponse 
Message()); /打印 错误 
throw new RuntimeException("server response error "); 
// 抛 出 运行 时 服务 器 返回 异常 


ial 


} 


} catch (Exception e) { 
print(e.toString()); /打印 错误 
throw new RuntimeException("Can't connection this url"); 
// 抛 出 运行 时 无 法 连接 的 异常 


} 
} 
mI 
* 获取 文件 名 
E 


private String getFileName(HttpURLConnection conn) { 
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String filename = this.downloadUtrl.substring(this.downloadUrl.lastIndexOf(") + 1) 
A, BBR AE) EAS EB ERE SE AK 
if(filename==null || "".equals(filename.trim())) { /如 果 获 取 不 到 文件 名 称 
for (inti= 0;; i++) { /无 限 循环 遍历 
String mine = conn.getHeaderField(1); 
/从 返回 的 流 中 获取 特定 索引 的 头 字段 值 
if (mine == null) break:/ 如 果 遍 历 到 了 返回 头 来 尾 这 退出 循环 
if("content-disposition".equals(conn.getHeaderFieldKey(1).toLowerCase())) { 
/获取 content-disposition 返回 头 字段 ， 里 面 可 能 会 包含 文件 名 
Matcher m = Pattern.compile(".*filename=(.*)").matcher(mine.toLowerCase()); 
/使 用 正则 表达 式 查 询 文件 名 
if(m.find()) return m.group(1); /如 果 有 符合 正则 表达 规则 的 字符 唱 


Ud 


} 
filename = UUID.randomUUID()+ "tmp"; /由 网 卡 上 的 标识 数字 (每 个 网 卡 都 有 
唯一 的 标识 号 ) 以 及 CPU 时 钟 的 唯一 数字 生成 的 一 个 16 字 节 的 三 进 制 作为 文件 名 
} 


return filename; 


[** 
* 开始 下 载 文件 
* @param listener 监听 下 载 数量 的 变化 ,如 果 不 需 要 了 解 实 时 下 载 的 数量 ,可 以 设置 为 null 
* @retun 已 下 载 文件 大 小 
* @throws Exception 
*/ 
public int download(DownloadProgressListener listener) throws Exception{ /进行 下 载 ， 并 抛 出 
异常 给 调用 者 ， 如 果 有 异常 的 话 
try { 
RandomAccessFile randOut = new RandomAccessFile(this.saveFile, "rwd"); 
if(this.fileSize>0) randOut.setLength(this.fileSize); /设置 文件 的 大 小 
randOut.close(); /关闭 该 文件 ， 使 设置 生效 
URL url = new URL(this.downloadUrl); //A URL instance specifies the location of a 
resource on the internet as specified by RFC 1738 


if(this.data.size() != this.threads.length){ /如 果 原 先 未 曾 下载 或 者 原先 的 下 载 线程 


数 与 现在 的 线程 数 不 一 致 


this.data.clear(); //Removes all elements from this Map, leaving it empty. 
for (int i = 0; i < this.threads.length; i++) { /遍历 线程 池 


this.data.put(i+1, 0); /初始 化 每 条 线程 已 经 下 载 的 数据 长 度 为 0 
j 
this.downloadedSize — 0; /设置 已 经 下 载 的 长 度 为 0 


} 
for (int i= 0; i < this.threads.length; i++) {// 开 启 线程 进行 下 载 
int downloadedLength = this.data.get(i+1); // 通 过 特定 的 线程 ID 获取 该 线 


程 已 经 下 载 的 数据 长 度 
if(downloadedLength < this.block && this.downloadedSize < this.fileSize){// 判 
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断 线程 是 否 已 经 完成 下 载 ， 否 则 继续 下 载 

this.threads[i] = new DownloadThread(this, url, this.saveFile, this.block, 
this.data.get(i+1), i+1); /初始 化 特定 id 的 线程 

this.threads[i].setPriority(7); /设置 线程 的 优先 级 ，Thread.NORM ` 
PRIORITY = 5 Thread.MIN PRIORITY = 1 Thread.MAX PRIORITY = 10 

this.threads[i].startQ; /启动 线程 

yelse { 
this.threads[i] = null; /表明 在 线程 已 经 完成 下 载 任务 


} 
fileService.delete(this.downloadUrD;/ 如 果 存 在 下 载 记录 ， 删 除 它 们 ， 然 后 重新 添加 
fileService.save(this.downloadUrl, this.data); /把 已 经 下 载 的 实时 数据 写 入 数据 库 
boolean notFinished = true;/ 下 载 未 完成 
while (notFinished) {// 循环 判断 所 有 线程 是 否 完成 下 载 

Thread.sleep(900); 

notFinished = false;// 假 定 全 部 线程 下 载 完 成 

for (int 1 = 0; 1 < this.threads.length; 1++){ 

if (this.threads[1] != null && !this.threads[1].isFinished()) { 

/如 果 发 现 线程 未 完成 下 载 
notFinished = true; /设置 标志 为 下 载 没 有 完成 
if(this.threads[1i].getDownloadedLength()== -1){ 

/如 果 下 载 失败 ,再 重新 在 已 经 下 载 的 数据 长 度 的 基础 上 下 载 
this.threads[i] = new DownloadThread(this, url, this.saveFile, 


过 | 


this.block, this.data.get(i+1), i+1); /重新 开辟 下 载 线程 
this.threads[i].setPriority(7); /设置 下 载 的 优先 级 
this.threads[i].start(); /开始 下 载 线程 
} 
} 
} 


if(listener!=null) listener.onDownloadSize(this.downloadedSize); 


/通知 目前 已 经 下 载 完 成 的 数据 长 度 


j 


if(downloadedSize == this.fileSize) fileService.delete(this.downloadUrl); 
/下 载 完成 删除 记录 
} catch (Exception e) { 
print(e.toString()); /打印 错误 
throw new Exception("File downloads error"); / 抛 出 文件 下 载 异 常 


j 


return this.downloadedSize; 


j 
[** 
* 获取 Http 响应 头 字段 
* @param http HttpURLConnection 对 象 
* @return 返回 头 字 段 的 LinkedHashMap 
E 
public static Map<String, String> getHttpResponseHeader(HttpURL Connection http) { 
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Map<String, String> header = new LinkedHashMap<String, String>(); 
/使 用 LinkedHashMap 保证 写 入 和 货 历 的 时 候 的 顺序 相同 ， 而 且 允 许 空 值 存在 
for(inti- 0; i++) { V 此 处 为 无 限 循环 ， 因 为 不 知道 头 字段 的 数量 
String fieldValue = http.getHeaderField(1); 
//getHeaderField(int n) 用 于 返回 第 n 个头 字 段 的 值 。 


"d 


if (fieldValue == null) break; /如 果 第 i 个 字段 没有 值 了 , 则 表明 头 字段 部 分 已 经 循 
环 完毕 ， 此 处 使 用 Break 退出 循环 


header.put(http.getHeaderFieldKey(i), fieldValue);  //getHeaderFieldKey(int alt J 
返回 第 n 个 头 字段 的 键 。 


} 


return header; 
} 
[** 
* 打印 Http 头 字段 
* @param http HttpURLConnection 对 象 
ij 
public static void printResponseHeader(HttpURL Connection http) { 
Map<String, String> header = getHttpResponseHeader(http); /获取 HTTP 响应 头 字 段 
for(Map.Entry<String, String> entry ` header.entrySet()) { 
/使 用 For-Each 循环 的 方式 遍历 获取 的 头 字段 的 值 ， 此 时 遍历 的 循序 和 输入 
的 顺序 相同 
String key = entry.getKey()!=null ? entry.getKey()+ ":" : ""; 
/ 当 有 键 的 时 候 这 获取 键 ， 如 果 没 有 则 为 空 字符 串 
print(key+ entry.getValue()); /答应 键 和 值 的 组 合 


[** 
* 打印 信息 
* @param msg 信息 字符 
of 
private static void print(String msg) { 
Log.i(TAG, msg); /使 用 LogCat 的 Information 方式 打印 信息 


} 
(6) 类 DownloadThread 在 文件 DownloadThread.java 中 定义 ， 有 具体 实现 代码 如 下 。 


[** 


* 下 载 线程 ， 根 据 具体 下 载 地 址 、 保 持 到 的 文件 、 下 载 块 的 大 小 、 已 经 下 载 的 数据 大 小 等 信息 进 


行 下 载 
SH 
public class DownloadThread extends Thread { 
private static final String TAG = "DownloadThread"; // 定 义 TAG， 方 便 日 子 的 打印 输出 
private File saveFile; /下 载 的 数据 保存 到 的 文件 
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private URL downUrl; /下 载 的 URL 

private int block; /每 条 线程 下 载 的 大 小 

private int threadId = -1; /初始 化 线程 id 设置 

private int downloadedLength; /该 线程 已 经 下 载 的 数据 长 度 
private boolean finished = false; /该 线程 是 否 完成 下 载 的 标志 


private FileDownloader downloader; /文件 下 载 器 
public DownloadThread(FileDownloader downloader, URL downUrl, File saveFile, int block, int 
downloadedLength, int threadId) { 
this.downUrl = downUrl; 
this.saveFile = saveFile; 
this.block = block; 
this.downloader = downloader; 
this.threadId = threadId; 
this.downloadedLength = downloadedLength; 


@Override 
public void run() { 
if(downloadedLength < block){// 未 下 载 完 成 
try { 
HttpURLConnection http = (HttpURLConnection) downUrl.openConnection(); 
/开启 HttpURLConnection 连接 
http.setConnectTimeout(5 * 1000); /设置 连接 超时 时 间 为 5 秒 钟 
http.setRequestMethod("GET"); /设置 请 求 的 方法 为 GET 
http.setRequestProperty(" Accept", "image/gif, image/jpeg, image/pjpeg, image/pjpeg, 
application/x-shockwave-flash, application/xaml+xml, application/vnd.ms-xpsdocument, application/x-ms-xbap, 
application/x-ms-application, application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword, */*"); 
/设置 客户 端 可 以 接受 的 返回 数据 类 型 
http.setRequestProperty(" Accept-Language", "zh-CN"); 
/设置 客户 端 使 用 的 语言 问 中 文 
http.setRequestProperty(" Referer", downUrl.toString()); 
/设置 请 求 的 来 源 , 便于 对 访问 来 源 进 行 统计 
http.setRequestProperty("Charset", "UTF-8"); /设置 通信 编码 为 UTF-8 
int startPos = block * (threadId - 1) + downloadedLength;/ 开 始 位 置 
int endPos = block * threadId -1; /结束 位 置 
http.setRequestProperty("Range", "bytes-" + startPos + "-"+ endPos); 
/设置 获取 实体 数据 的 范围 ,如 果 超 过 了 实体 数据 的 大 小 会 自动 返回 实际 的 数据 大 小 
http.setRequestProperty("User-Agent", "Mozilla/4.0 (compatible; MSIE 4.0; 
Windows NT 4.2; Trident/4.0; NET CLR 1.1.4322; NET CLR 2.0.50727; NET CLR 3.0.04506.30; NET CLR 
3.0.4506.2152; NET CLR 3.4.30729)"); /客户 端 用 户 代 理 
http.setRequestProperty("Connection", "Keep-Alive"); /使 用 长 连接 
InputStream inStream = http.getInputStream(); /获取 远程 连接 的 输入 流 


imi 


byte[] buffer = new byte[1024]; /设置 本 地 数据 缓存 的 大 小 为 1MB 
int offset = 0; /设置 每 次 读 取 的 数据 量 


print("Thread " + this.threadId + " starts to download from position "+ startPos); 
/打印 该 线程 开始 下 载 的 位 置 
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RandomAccessFile threadFile = new RandomAccessFile(this.saveFile, "rwd"); 
//If the file does not already exist then an attempt will be made to create it and it require that every update to the 
file's content be written synchronously to the underlying storage device. 
threadFile.seek(startPos), /文件 指针 指向 开始 下 载 的 位 置 
while (!downloader.getExited() && (offset = inStream.read(buffer, 0, 1024)) != 
-D { V 但 用 户 没有 要 求 停止 下 载 ， 同 时 没有 到 达 请 求 数 据 的 末尾 时 候 会 一 直 循 环 读 取 数 据 


threadFile.write(buffer, 0, offset); /直接 把 数据 写 到 文件 中 
downloadedLength += offset; /把 新 下 载 的 已 经 写 到 文件 中 
的 数据 加 入 到 下 载 长 度 中 


downloader.update(this.threadId, downloadedLength); 
/把 该 线程 已 经 下 载 的 数据 长 度 更 新 到 数据 库 和 内 存 哈 希 表 中 
downloader.append(offset); 
/把 新 下 载 的 数据 长 度 加 入 到 已 经 下 载 的 数据 总 长 度 


| 


} // 该 线程 下 载 数据 完毕 或 者 下 载 被 用 户 停止 
threadFile.close(); 
inStream.close(); 
if(downloader.getExited()) 
print("Thread " + this.threadId + " has been paused"); 
} 
else 
1 
print(" Thread " + this.threadId + " download finish"); 
} 
this.finished — true; /设置 完成 标志 为 true, 无 论 是 下 载 完 成 还 是 用 户主 动 
中 断 下 载 
} catch (Exception e) { // 出 现 异 常 
this.downloadedLength = -1; /设置 该 线程 已 经 下 载 的 长 度 为 -1 
print("Thread "+ this.threadId+ ":"+ e); ` AT EN HH St Et E. 
} 
} 
} 
[** 


* 打印 信息 
* @param msg 信息 
E 
private static void print(String msg)1 
Log.i(TAG, msg); /使 用 Logcat 的 Information 方式 打印 信息 


} 
[** 
* 下 载 是 否 完 成 
* (Mreturn 
e 
public boolean isFinished() { 
return finished; 
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} 


[** 
* 已 经 下 载 的 内 容 大 小 
* @return 如 果 返 回 值 为 -1, 代 表 下 载 失 败 
public long getDownloadedLength() { 
return downloadedLength; 


isi 


j 


(7) 在 类 FileDownloader 中 调用 了 类 DownloadProgressListener 2K Hi Ur FRR, 28 
DownloadProgressListener 在 文件 DownloadProgressListener.java 中 定义 ， 有 具体 实现 代码 
如 下 。 


public interface DownloadProgressListener { 
[** 
* 下 载 进度 监听 方法 获取 和 处 理 下 载 点 数据 的 大 小 
* @param size 数据 大 小 
wi 
public void onDownloadSize(int size); 


j 


T 


(8) 编写 文件 主 Activity 文件 MultipleThreadDownloadAndroid.java， 上 有 具体 实现 代码 
如 下 。 


* 主 界面 ， 负 责 下 载 界面 的 显示 、 与 用 户 交 互 、 响 应 用 户 事件 等 


public class MultipleThreadDownloadAndroid 
extends Activity { 


private static final int PROCESSING = 1; /正在 下 载 实时 数据 传输 Message 标志 
private static final int FAILURE = -1; /下 载 失 败 时 的 Message 标志 
private EditText pathText; /下 载 输 入 文本 框 
private TextView resultView; /现在 进度 显示 百分比 文本 框 
private Button downloadButton; /下 载 按钮 ， 可 以 触发 下 载 事件 
private Button stopbutton; /停止 按钮 ， 可 以 停止 下 载 
private ProgressBar progressBar; /下 载 进度 条 , 实时 图 形 化 的 显示 进度 信息 
//hanlder 对 象 的 作用 是 用 于 向 创建 Hander 对 象 所 在 的 线程 所 绑 定 的 消息 队列 发 送 消息 并 处 
HDD 


private Handler handler = new UIHander(); 
private final class UIHander extends Handler { 

/* * 
* 系统 会 自动 调用 的 回调 方法 ， 用 于 处 理 消息 事件 
* Mesaage 一 般 会 包含 消息 的 标志 和 消息 的 内 容 以 及 消息 的 处 理 器 Handler 
St 


public void handleMessage(Message msg) { 
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switch (msg.what) { 


case PROCESSING: /下 载 时 
int size = msg.getData().getInt("size"); /从 消息 中 获取 已 经 下 载 的 数据 长 度 
progressBar.setProgress(size); /设置 进度 条 的 进度 
float num = (float)progressBar.getProgress() / (float) 
progressBar.getMax(); /计算 已 经 下 载 的 百分比 ,此 处 需要 转换 为 
浮 点 数 计算 


int result = (int)(num * 100); 


/把 获取 的 浮 点 数 计算 结构 转化 为 整数 


resultView.setText(result4- "%"); /把 下 载 的 百分比 显示 在 界 


if(progressBar.getProgress()== progressBar.getMax()) { 
/当下 载 完成 时 
Toast.makeText(getA pplicationContext(), R.string. 


四 显示 控件 上 


success, Toast. LENGTH LONG).show(); // 使 用 Toast 技术 提示 用 户 下 载 完 成 


} 

break; 
case -1: /下 载 失 败 时 

Toast.makeText(getA pplicationContext(), R.string.error, 


Toast.LENGTH_LONG).show(); /提示 用 户 下 载 失 败 


break; 


} 
@Override 
public void onCreate(Bundle savedInstanceState) { 


/应 用 程序 启动 时 会 首先 调用 且 在 应 用 程序 整个 生命 周期 中 只 会 调用 


化 亚 作 
super.onCreate(savedInstanceState); 
/使 用 父 类 的 onCreate 用 做 屏幕 主 界面 的 底层 和 基本 绘制 工作 


-次 ， 适 合 于 初始 


setContentView(R.layout.main); /根据 XML 界面 文件 设 


EI 


pathText = (EditText) this.findViewBylId(R.id.path); /获取 下 载 URL 的 文本 输入 框 对 象 


resultView = (TextView) this.findViewByld(R.id.result View); 

/获取 显示 下 载 百 分 比 文本 控件 对 象 

downloadButton = (Button) this.findViewById(R.id.downloadbutton); 
/获取 下 载 按钮 对 象 

stopbutton = (Button) this.findViewById(R.id.stopbutton); 
/获取 停止 下 载 按钮 对 象 

progressBar = (ProgressBar) this. find ViewByld(R.id.progressBar); 

// 获 取 进 度 条 对 象 

ButtonClickListener listener = new ButtonClickListener(); 


/声明 并 定义 按钮 监听 器 对 象 


downloadButton.setOnClickListener(listener); /设置 下 载 按钮 的 监听 器 对 象 
stopbutton.setOnClickListener(listener); /设置 停止 下 载 按钮 的 监听 器 对 象 


[** 


* 按钮 监听 器 实现 类 


* 
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yf 
private final class ButtonClickListener implements View.OnClickListener { 
public void onClick(View v) { /该 方法 在 注册 了 该 按钮 监听 器 的 对 象 被 单 击 
时 会 自动 调用 ， 用 于 响应 单 击 事件 
switch (v.getId()) { /获取 单 击 对 象 的 ID 
case R.id.downloadbutton: / 当 单 击 下 载 按钮 时 


String path = pathText.getText().toString(); /获取 下 载 路 径 
if(Environment.getExternalStorageState().equals 
(Environment MEDIA MOUNTED))( /获取 SDCard 是 否 存在 ， 当 SDCard 存在 时 
File saveDir = Environment.getExternalStorageDirectory(); 
/获取 SDCard 根 目录 文件 
File saveDirl = Environment.getExternalStoragePublicDirectory(Environment. 


DIRECTORY MOVIES); 
File saveDirll = getApplicationContext().getExternalFilesDir(Environment. 
DIRECTORY MOVIES); 


download(path, saveDir11); /下 载 文件 
Lelsef // 当 SDCard 不 存在 时 


Toast.makeText(getApplicationContext(), R.string. 
sdcarderror, Toast.LENGTH_LONG).show(); /提示 用 户 SDCard 不 存在 


j 
downloadButton.setEnabled(false); /设置 下 载 按钮 不 可 用 
stopbutton.setEnabled(true); /设置 停止 下 载 按钮 可 用 
break; 
case R.id.stopbutton: / 当 单 击 停止 下 载 按钮 时 
exit(); /停止 下 载 
downloadButton.setEnabled(true); /设置 下 载 按钮 可 用 
stopbutton.setEnabled(false); /设置 停止 按钮 不 可 用 
break; 
j 
} 
private DownloadTask task; /声明 下 载 执行 者 
/* * 
* 退出 下 载 
a 
public void exit() { 
if(task!=null) task.exit(); /如 果 有 下 载 对 象 时 ， 退 出 下 载 
} 
/* * 


* 下 载 资源 ， 生 命 下 载 执行 者 并 开辟 线程 开始 现在 
* @param path 下 载 的 路 径 
* @param saveDir ”保存 文 伯 


t 


Ey 
private void download(String path, File saveDir){ /此 方法 运行 在 主线 程 
task =new DownloadTask(path, saveDir); /实例 化 下 载 任 务 
new Thread(task).start(); /开始 下 载 
} 
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/* 
* UI 控件 画面 的 重 绘 (更 新 ) 是 由 主线 程 负责 处 理 的 , 如 果 在 子 线程 中 更 新 UI 控件 的 值 , 更 新 
后 的 值 不 会 重 绘 到 屏幕 上 


ey 
private final class DownloadTask implements Runnable { 
private String path; /下 载 路 径 
private File saveDir; /下 载 到 保存 到 的 文件 
private FileDownloader loader; // 文 件 下 载 器 (下 载 线程 的 容器 ) 
/* * 


* 构造 方法 ， 实 现 变量 初始 化 
*@param path 下 载 路 径 
* @param saveDir ”下 载 要 保存 到 的 文件 


public DownloadTask(String path, File saveDir) { 
this.path = path; 
this.saveDir = saveDir; 
} 
[** 
* 退出 下 载 
oy 
public void exit() ( 
if(loader!=null) loader.exit(); /如 果 下 载 器 存在 的 话 则 退出 下 载 


j 


DownloadProgressListener downloadProgressListener — new 
DownloadProgressListener() { /开始 下 载 ， 并 设置 下 载 的 监听 器 


/* * 
* 下 载 的 文件 长 度 会 不 断 的 被 传 入 该 回调 方法 
ey 
public void onDownloadSize(int size) { 
Message msg = new Message(); // 新 建立 一 个 Message 对 象 
msg.what = PROCESSING; Ii ID 为 1; 
msg.getData().putInt("size", size); /把 文件 下 载 的 size 设置 进 Message 对 象 
handler.sendMessage(msg); /通过 handler 发 送 消息 到 消息 队列 
j 
h 
IEE 
* 下 载 线程 的 执行 方法 ， 会 被 系统 自动 调用 
public void run() { 
try { 
loader = new FileDownloader(getA pplicationContext(), 
path, saveDir, 3); // 初 始 化 下 载 


progressBar.setMax(loader.getFileSize()); /设置 进度 条 的 最 大 刻度 
loader.download(downloadProgressListener); 


} catch (Exception e) { 
e.printStackTrace(); 
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handler.sendMessage(handler.obtainMessage(FAILURE)); 
/下 载 失 败 时 向 消息 队列 发 送 消息 
/*Message message = handler.obtainMessage(); 
message.what = FAILURE;*/ 


(9) 在 文件 AndroidManifest.xml 中 声明 使 用 网 络 的 权限 和 操作 SDCard 的 权限 ， 有 具体 实 
现代 码 如 下 。 


<!-- 访问 internet 权限 --> 

<uses-permission android:name="android.permission.INTERNET"/> 

<!-- 在 SDCard 中 创建 与 删除 文件 权限 --> 

<uses-permission android:name="android.permission MOUNT UNMOUNT FILESYSTEMS"/> 
<!-- 往 SDCard 写 入 数据 权限 --> 

<uses-permission android:name="android.permission. WRITE EXTERNAL STORAGE"/> 


BIE ut, ESSE BISPASEHE, HVT CR MIE 4-5 所 示 。 


dë 


ei MultipleThreadDownloadAndro... 


Jownload URL 


http://1 92.168.1.100:8080/ 


ServerForMultipleT hreadDownloader 
/mmm.mp3 


Start Downloading 


图 4-5 执行 效果 


45 ”上 传 文件 到 远程 服务 器 


在 本 节 的 内 容 中 ， 将 通过 一 个 具体 实例 的 实现 过 程 ， 详 细 讲解 在 Android 系统 中 上 传 文 
件 的 基本 方法 。 


题目 目的 源码 路 径 
实例 4-5 上 传 文件 到 远程 服务 器 daima\4\chuan 


本 实例 的 具体 实现 流程 如 下 。 
COD 编写 界面 布局 文件 main.xml， 主 要 代码 如 下 。 


<TextView 
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android:id="@+id/myText1" 
android:layout width-"wrap content" 
android:layout height-" 
android:text-"(a)string/str title" 
android:textSize="20sp" 
android:textColor-"(g)drawable/black" 


android:layout_x="10px" 


wrap content" 


=i 


android:layout_y="12px" 


> 
</TextView> 
<TextView 


android:id="@+id/myText2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textSize="16sp" 
android:textColor-"(g)drawable/black" 
android:layout_x="10px" 
android:layout_y="52px" 


> 


</TextView> 

<TextView 
android:id="@+id/myText3" 
android:layout width-"wrap content" 


ZR 


android:layout_height="wrap_content" 
android:textSize="16sp" 
android:textColor-"(g)drawable/black" 
android:layout_x="10px" 
android:layout_y="102px" 

> 

</TextView> 

<Button 
android:id="(@+id/myButton" 
android:layout_width="92px" 
android:layout_height="49px" 
android:text="@string/str_button" 
android:textSize="15sp" 
android:layout_x="90px" 
android:layout_y="170px" 

> 


</Button> 


(2) 编 


O 分 别 声明 变量 newName. uploadFile 和 actionUrl, 


pu 
{ 


blic class chuan extends Activity 


P 变量 声明 
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写 主 程序 文件 chuan.java， 其 具体 实现 流程 如 下 。 


具体 代码 如 下 。 
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* newName: 上 传 后 在 服务 器 上 的 文件 名 称 
* uploadFile: 要 上 传 的 文件 路 径 
* actionUrl: 服务 器 上 对 应 的 程序 路 径 * 


private String newName="image.jpg"; 


private String uploadFile="/data/data/irdc.example9/image.jpg"; 
private String actionUrl="http://125.125.0.1/upload/upload.jsp"; 
private TextView mTextl; 

private TextView mText2; 

private Button mButton; 


O 通过 mTextl 对 象 获 取 文 件 路 径 ， 根 据 mText2 H ZALEWA cee dH 


传 方法 uploadFileO0。 有 具体 代码 如 下 。 


public void onCreate(Bundle savedInstanceState) 

{ 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
mTextl = (TextView) findViewByld(R.id.myText2); 
mTextl.setText(" 文 件 路 径 : \n"+uploadFile); 
mText2 = (TextView) findViewByld(R.id.myText3); 
mText2.setText(" 上 传 网 址 : \n"+actionUrl); 
/* 设置 mButton 的 onClick 事件 处 理 */ 
mButton = (Button) findViewById(R.id.my Button); 
mButton.setOnClickListener(new View.OnClickListener() 
1 

public void onClick(View v) 


{ 
uploadFile(); 


35 
j 


O 定义 方法 uploadFile0 将 文件 上 传 至 Server， 有 具体 代码 如 下 。 
/# 上 传 文件 至 Server 的 方法 */ 
private void uploadFile() 
{ 
String end = "\r\n"; 
String twoHyphens = "--"; 
String boundary = "*****"; 
try 
{ 
URL url =new URL(actionUrl); 
Http URLConnection con=(HttpURLConnection)url.openConnection(); 
/* 允许 Input, Output, AMEH Cache */ 
con.setDoInput(true); 
con.setDoOutput(true); 
con.setUseCaches(false); 
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} 


/* 设置 传送 的 method=POST */ 
con.setRequestMethod("POST"); 
/* setRequestProperty */ 


con.setRequestProperty("Connection", "Keep-Alive"); 
con.setRequestProperty("Charset", "UTF-8"); 


con.setRequestProperty("Content-Type", 


SAS TH. 


"multipart/form-data;boundary="+boundary); 


/* 设置 DataOutputStream */ 
DataOutputStream ds = 


new DataOutputStream(con.getOutputStream()); 
ds.writeBytes(twoHyphens + boundary + end); 
ds.writeBytes("Content-Disposition: form-data; " + 


"name=\"file1\";filename=\"" + 


newName +"\"" + end); 


ds.writeBytes(end); 
/* 取得 文件 的 FileInputStream */ 


FileInputStream fStream = new FileInputStream(uploadFile); 


P* 设置 每 次 写 入 1024bytes */ 
int bufferSize = 1024; 
byte[] buffer = new byte[bufferSize]; 
int length = -1; 
el 从 文件 读 取 数 据 至 缓冲 区 */ 
while((length = fStream.read(buffer)) 
1 
上 将 资料 号 入 DataOutputStream 
ds.write(buffer, 0, length); 
} 


ds.writeBytes(end); 


ES 


UE 


ds.writeBytes(twoHyphens + boundary + twoHyphens + end); 


fStream.close(); 
ds.flush(); 
/* 取得 Response 内 容 */ 


InputStream is = con.getInputStream(); 


int ch; 
StringBuffer b =new StringBuffer(); 
while( (ch = is.read() ) !=-1 ) 
1 
b.append( (char)ch ); 
} 


/* 将 Response 显示 在 Dialog XJ ift 
showDialog(b.toString().trim()); 

/* 关闭 DataOutputStream */ 
ds.close(); 


catch(Exception e) 


1 


Er ox 


上 传 数据 
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showDialog(""+e); 
} 
} 


TFA 


O 定义 方法 showDialog(String mess) 来 显示 提示 对 话 框 ， 具 体 实现 代码 如 下 。 


显示 Dialog 的 方法 */ 
private void showDialog(String mess) 
{ 
new AlertDialog.Builder(example9.this).setTitle(" Message") 
.setMessage(mess) 
.setNegativeButton(" ffl z€ ";new DialogInterface.OnClickListener() 


1 
public void onClick(DialogInterface dialog, int which) 


执行 后 单 击 “ 上 传 ”按钮 可 以 将 指定 的 文件 上 传 到 服务 器 ， 如 图 4-6 所 示 。 


上 传 到 服务 器 


文件 路 径 : 
/data/data/irdc.shili9/image. 


ena. 
http://127.127.0.1/upload/upload.jsp 


EI 


图 4-6 执行 效果 
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在 Andorid 网 络 开发 应 用 中 ， 可 以 通过 GET 方式 或 POST 方式 上 传 数 据 。 在 本 节 的 内 容 
中 ， 将 详细 讲解 使 用 GET 方式 上 传 数据 的 基本 方法 。 


4.6.1 使 用 GET 方式 上 传 数据 的 流程 


通过 GET 和 POST 方式 上 传 数据 的 具体 区 别 如 下 。 

口 GET 上 传 的 数据 一 般 是 很 小 的 并 且 安全 性 不 高 的 数据 。 
QO POST 上 传 的 数据 适用 于 数据 量 大 ， 数 据 类 型 复杂 ， 数 据 安全 性 要 求 较 高 的 地 方 。 
在 Android 网 络 开发 应 用 中 ， 采 用 GET 方式 向 服务 器 传递 数据 的 基本 步骤 如 下 。 
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CD 利用 Map 集合 对 数据 进行 获取 并 进行 数据 处 理 ， 例 如 : 


H 


if (params!=null&&!params.isEmpty()) { 
for (Map.Entry<String, String> entry:params.entrySet()) { 
sb.append(entry.getKey()).append( 
sb.append(URLEncoder.encode(entry.getValue(),encoding)); 
sb.append("&"); 
j 
sb.deleteCharAt(sb.length()-1); 


"ncm. 
, 


j 


(2) 新 建 一 个 StringBuilder 对 象 ， 例 如 : 


sb=new StringBuilder() 


(3) 新 建 一 个 HttpURLConnection DI URL 对 象 ， 打 开 连 接 并 传递 服务 器 的 path， 例 如 : 


connection=(HttpURLConnection) new URL(path).openConnection(); 


(4) 设置 超时 和 连接 的 方式 ， 例 如 : 


Ed 


connection.setConnectTimeout(5000); 
connection.setRequestMethod(" GET"); 


4.6.2 ”实战 演练 一 一 采用 GET 方法 向 服务 器 传递 数据 


在 本 节 的 内 容 中 ， 将 通过 一 个 具体 实例 的 实现 过 程 ， 介 绍 在 Android 系统 中 采用 GET 77 
式 向 服务 器 传递 数据 的 基本 方法 。 


是 日 “的 "ETT 
ES TE Android RAP RH GET AM l 

实例 4-6 Sat 

实 服务 器 传递 数据 DEER 


本 实例 的 具体 实现 流程 如 下 。 

(1) 打开 Eclipse， 新 建 一 个 名 为 “ServerForGETMethod” 的 Web 工程 ， 并 自动 生成 配置 
文件 web.xml. 

(2) 创建 一 个 名 为 “ServletForGETMethod” 的 Servlet， 功 能 是 接收 并 处 理 通 
式 上 传 的 数据 。 实 现 文件 ServletForGETMethod.java 的 具体 代码 如 下 。 


G 
e 
rri 
- 
过 


@WebServlet("/ServletForGETMethod") 
public class ServletForGETMethod extends HttpServlet { 
private static final long serial VersionUID = 1L; 
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws 
ServletException, IOException { 
// String name= request.getParameter("name"); 
String age= request.getParameter("age"); 
System.out.println("name: " + name ); 
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System.out.println("age: "+ age ); 


j 


在 上 述 代码 中 ， 为 了 避免 出 现 中 文 乱码 的 问题 ， 特 意 实现 了 ISO8855-1 编码 和 UTF-8 编 
人 码 的 转换 处 理 。 通 过 下 面 的 代码 ， 可 以 很 好 地 解决 乱码 问题 。 


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 

<% 

String zh_value=new String(request.getParameter("zh_value").getBytes("ISO-8855-1"),"UTF-8") 
%> 


由 此 可 见 ， 在 使 用 GET 方式 传递 数据 时 ， 需 要 使 用 如 下 的 代码 声明 当前 页 的 字符 集 。 


pageEncoding="UTF-8" 


G) 在 配置 文件 web.xml 中 配置 ServletfForGETMethod， 具 体 实现 代码 如 下 。 


<?xml version="1.0" encoding="UTF-8"?> 
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/ 
xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app 2 5.xsd" xsi:schemaLocation="http://java. 
sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0"> 

<display-name>ServerForGETMethod</display-name> 

<servlet> 
<display-name>ServletForGETMethod</display-name> 
<servlet-name>ServletForGETMethod</servlet-name> 
<servlet-class>com.guan.internet.servlet.ServletForGET Method</servlet-class> 

</servlet> 

<servlet-mapping> 
<servlet-name>ServletForGETMethod</servlet-name> 
<url-pattern>/ServletForGETMethod</url-pattern> 

</servlet-mapping> 

<welcome-file-list> 
<welcome-file>index.html</welcome-file> 
<welcome-file>index.htm</welcome-file> 
<welcome-file>index.jsp</welcome-file> 
<welcome-file>default.html</welcome-file> 
<welcome-file>default.htm</welcome-file> 
<welcome-file>default.jsp</welcome-file> 

</welcome-file-list> 


</web-app> 


Tur 


(4) 打开 Eclipse， 新 建 一 个 名 为 “UserImformation” 的 Android 工程 。 然 后 编写 界面 布 
文件 main.xzml， 上 有 具体 实现 代码 如 下 。 


all 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
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android:layout width-"fill parent" 
android:layout height-"fill parent" 
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android:orientation-"vertical" > 
<TextView 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/title" 
/> 
<EditText 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:id="@+id/title" 
/> 
<TextView 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/length" 
[7 
<EditText 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:numeric="integer" 
android:id="@+id/length" 
> 
<Button 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="(@string/button" 
android:onClick="save" 

JE 


</LinearLayout> 


SAS TH. 


(5) 编写 文件 UserInformationActivityjava， 有 具体 实现 代码 如 下 。 


public class UserInformationActivity extends Activity { 
private EditText titleText; 
private EditText lengthText; 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


titleText = (EditText) this.findViewById(R..id.title); 
lengthText = (EditText) this.findViewByld(R.id.length); 


public void save(View vil 
String title = titleText.getText().toString(); 


上 传 数据 
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String length = lengthText.getText().toString(); 


try { 
boolean result = false; 


result = UserInformationService.save(title, length); 


if(result) { 
Toast.makeText(this, R.string.success, 1).show(); 
jelse( 
Toast.makeText(this, R.string.fail, 1).show(); 
j 
} catch (Exception e) { 
e.printStackTrace(); 
Toast.makeText(this, R.string.fail, 1).show(); 


j 


(6) 编写 业务 类 的 实现 文件 UserInformationService.java， 主 要 实现 代码 如 下 。 


public class UserInformationService { 
public static boolean save(String title, String length) throws Exception { 
String path = "http://192.165.1.100:8080/ServerForGETMethod/ServletForGETMethod"; 
Map<String, String> params = new HashMap<String, String>(); 
params.put("name", title); 
params.put("age", length); 
return sendGETRequest(path, params, "UTF-8"); 
} 
[** 
* Kix GET 请 求 
* @param path 请 求 路 径 
* @param params 请 求 参 数 
* (Oreturn 
E 
private static boolean sendGETRequest(String path, Map<String, String> params, String encoding) 
throws Exception { 
StringBuilder sb = new StringBuilder(path); 
if(params!=null && !params.isEmpty()) { 
sb.append("?"); 
for(Map.Entry<String, String> entry ` params.entrySet()) { 
sb.append(entry.getK ey()).append("—"); 
sb.append(URLEncoder.encode(entry.getValue(), encoding)); 
sb.append(" &"); 
j 
sb.deleteCharAt(sb.length() - 1); 
j 
HttpURLConnection conn = (HttpURLConnection) new URL(sb.toString()).openConnection(); 
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conn.setConnectTimeout(5000); 

conn.setRequestMethod("GET"); 

if(conn.getResponseCode()== 200) { 
return true; 


j 


return fal 


j 


se; 


n 


CD 编写 配置 文件 AndroidManifestxml， 声 明 网 络 访问 权限 ， 主 要 代码 如 下 。 


<uses-sdk android:minSdkVersion="18" /> 


<application 


android:icon="@drawable/ic_launcher" 


android:label="@string/app_name" > 


<activity 
androi 
androi 


d:label="@string/app_name" 


d:name 


<intent-filter > 
«action android:name="android.intent.action. MAIN" /> 
«category android:name="android.intent.category. LAUNCHER" /> 


</intent-filter> 


</activity> 


</application> 


<uses-permission android:name="android.permission.INTERNET"/> 


</manifest> 


到 此 为 止 ， 整 个 实例 讲解 完毕 ， 执 行 后 的 效果 如 图 4-7 所 示 。 和 输入 用 户 名 和 年 龄 后 单 避 


save 按钮， 会 将 输入 的 数据 上 传 至 服务 器 。 


D Userlnformation 


name 


图 4-7 执行 效果 


44 POST 上 传 数据 


在 Android 网 络 应 用 


P. XH POST 方式 向 服务 器 传递 数据 的 基本 步 又 如 下 。 


com.guan.internet.userInformation.get.UserInformationActivity" > 


fen 
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CD 利用 Map 集合 对 数据 进行 获取 并 进行 数据 处 理 ， 例 如 : 


if (params!=null&&!params.isEmpty()) { 
for (Map.Entry<String, String> entry:params.entrySet()) { 
sb.append(entry.getKey()).append( 
sb.append(URLEncoder.encode(entry.getValue(),encoding)); 
sb.append("&"); 
} 
sb.deleteCharAt(sb.length()-1); 


j 


"ncm. 
, 


(2) 新 建 一 个 StringBuilder 对 象 ， 得 到 POST 传 给 服务 器 的 数据 ， 例 如 : 


sb=new StringBuilder() 
byte[] data=sb.toString().getBytes(); 


(3) 新 建 一 个 HttpURLConnection DI URL 对 象 ， 打 开 连 接 并 传递 服务 器 的 path， 例 如 : 


connection=(HttpURLConnection) new URL(path).openConnection(); 


(4) 设置 超时 和 允许 对 外 连接 数据 ， 例 如 : 


KN 


connection.setDoOutput(true); 


(5) 设置 连接 的 setRequestProperty 属性 ， 例 如 : 


connection.setRequestProperty("Content-Type","application/x-www-form-urlencoded"); 


connection.setRequestProperty(" Content-Length", data.length+""); 


(6) 得 到 连接 输出 流 ， 例 如 : 
outputStream =connection.getOutputStream(); 


(7) 把 得 到 的 数据 写 入 输出 流 中 并 局 


= 


新 ， 例 如 : 


outputStream. write(data); 
outputStream.flush(); 


在 接 下 来 的 内 容 中 ,也 将 通过 一 个 具体 实例 的 实现 过 程 ,介绍 在 Android 系统 中 采用 POST 
方式 向 服务 器 传递 数据 的 基本 方法 。 


题 H 的 源码 路 径 
A id 系统 中 采用 方式 
实例 4-7 在 Android 系统 中 采用 POST 方式 向 daima\4\post 


服务 器 传递 数据 


本 实例 的 具体 实现 流程 如 下 。 


(1) 打开 Eclipse， 新 建 一 个 名 为 “ServerForPOSTMethod” 的 Web T. 


B. 


并 自动 生成 配 


置 文件 web.xml. 


(2) 创建 一 个 名 为 “ServletForPOSTMethod” 的 Servlet， 功 能 是 接收 并 处 理 通过 POST 
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方式 上 传 的 数据 。 实 现 文件 ServletForPOSTMethod.java 的 具体 代码 如 下 。 


@WebServlet("/ServletForPOSTMethod") 
public class ServletForPOSTMethod extends HttpServlet { 
private static final long serialVersionUID = 1L; 
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws 
ServletException, IOException { 
String name= request.getParameter("name"); 
String age- request.getParameter("age"); 
System.out.println("name from POST method: " + name ); 
System.out.println("age from POST method: " + age ); 


j 


(3) 在 配置 文件 web.xml 中 配置 ServletForGETMethod， 具 体 实 现代 码 如 下 。 


<?xml version="1.0" encoding="UTF-8"?> 
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/ 
xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java. 
sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app 3 0.xsd" id="WebApp_ID" version="3.0"> 
<display-name>ServerForPOSTMethod</display-name> 
<welcome-file-list> 
<welcome-file>index.html</welcome-file> 
<welcome-file>index.htm</welcome-file> 
<welcome-file>index.jsp</welcome-file> 
<welcome-file>default.html</welcome-file> 
<welcome-file>default.htm</welcome-file> 
<welcome-file>default.jsp</welcome-file> 
</welcome-file-list> 
</web-app> 


(4) 打 开 Eclipse, 新建 一 个 名 为 ‘POST” 的 Android 工程 ,然后 编写 界面 布局 文件 main.xml， 
具体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 


android:orientation-"vertical" > 
<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/title" 
/> 
<EditText 

android:layout width-"fill parent" 


android:layout height-"wrap content" 
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android:id="@+id/title" 
[^ 
«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/length" 
[^ 
«EditText 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:numeric="integer" 
android:id="@+id/length" 
> 
<Button 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/button" 
android:onClick="save" 
j= 


</LinearLayout> 


(5) 编写 文件 UploadUserInformationByPOSTActivity.java， 有 具体 实现 代码 如 下 。 


public class UploadUserInformationByPOSTActivity extends Activity { 
private EditText titleText; 
private EditText lengthText; 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
titleText = (EditText) this.find ViewByld(R.id.title); 
lengthText = (EditText) this.find ViewByld(R.id.length); 
} 
public void save(View vil 
String title = titleText. getText().toString(); 
String length = lengthText.getText().toString(); 
try { 
boolean result = false; 
result = UploadUserInformationByPostService.save(title, length); 


if(result) { 
Toast.makeText(this, R.string.success, 1).show(); 
yelse { 


Toast.makeText(this, R.string.fail, 1).show(); 


j 


} catch (Exception e) { 
e.printStackTrace(); 
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Toast.makeText(this, R.string.fail, 1).show(); 


j 


(6) 编 写 业 务 类 的 实现 文件 UploadUserInformationByPostService.java, 主要 实现 代码 如 下 。 


public class UploadUserInformationByPostService { 

public static boolean save(String title, String length) throws Exception { 
String path = "http://192.165.1.100:8080/ServerForPOSTMethod/ServletForPOSTMethod"; 
Map<String, String> params = new HashMap<String, String>(); 
params.put("name", title); 
params.put("age", length); 
return sendPOSTRequest(path, params, "UTF-8"); 

} 


[** 
* BIL POST 请 求 
* @param path 请 求 路 径 
* @param params 请 求 参 数 
* (Oreturn 
*/ 
private static boolean sendPOSTRequest(String path, Map<String, String> params, String encoding) 
throws Exception { 
StringBuilder sb = new StringBuilder(); 
if(params!=null && !params.isEmpty()) { 
for(Map.Entry<String, String> entry ` params.entrySet())( 
sb.append(entry.getK ey()).append("—"); 
sb.append(URLEncoder.encode(entry.getValue(), encoding)); 
sb.append(" &"); 
} 
sb.deleteCharAt(sb.length() - 1); 
} 
byte[] data = sb.toString().getBytes(); 
HttpURLConnection conn = (HttpURLConnection) new URL(path).openConnection(); 
conn.setConnectTimeout(5000); 
conn.setRequestMethod("POST"); 
conn.setDoOutput(true);// 允 许 对 外 传输 数据 
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded"); 
conn.setRequestProperty("Content-Length", data.length+""); 
OutputStream outStream = conn.getOutputStream(); 
outStream.write(data); 
outStream.flush(); 
if(conn.getResponseCode()== 200) { 
return true; 
j 


return false; 
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CD 编写 配置 文件 AndroidManifest.xml， 声 明 网 络 访问 权限 ， 主 要 代码 如 下 。 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com.guan.internet.userInformation.post" 
android:versionCode-" 1" 
android:versionName="1.0" > 
<uses-sdk android:minSdkVersion="8" /> 
<application 
android:icon="(@drawable/ic_launcher" 
android:label="@string/app_name" > 
<activity 
android:label="@string/app_name" 
android:name="com.guan.internet.userInformation.post.UploadUserInformationByPOST Activity" > 
<intent-filter > 
«action android:name-"android.intent.action. MAIN" /> 
«category android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
<uses-permission android:name="android.permission.INTERNET"/> 
</manifest> 


整个 实例 讲解 完毕 ， 执 行 后 的 效果 如 图 4-8 所 示 。 输 入 用 户 名 和 年 龄 后 单 击 save 按钮 ， 
会 将 输入 的 数据 上 传 至 服务 器 。 


UploadUserinformationByPOST 0 


name 


图 4-8 执行 效果 
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在 网 络 传输 应 用 中 ， 通 常 使 月 
数据 的 过 程 中 ， 需 要 通过 


H TCP. IP # 
个 双向 的 通信 连接 


这 个 双向 链 路 的 一 端 称 为 Socket, — Socket 通常 
H, Socket 是 Java 网 络 编程 的 核心 ， 而 可 
Pp， 将 详细 讲解 在 Android 系统 中 使 


编程 应 用 
在 本 章 的 内 容 


5.1 Socket 编程 初步 


在 网 络 编 


gs 


FP 的 两 个 主要 问题 ， 


位 、 数 据 传输 的 路 


一 个 是 如 
个 就 是 找到 主机 后 如 何 可 靠 高 效 地 进行 数据 传 
» FA IP 地 址 可 以 唯一 地 有 有 


输 。 在 TCP/IP ! 


22 


何 准确 地 定位 网 络 上 的 一 台 或 多 台 主 机 ;， 男 一 


Socket 数据 通信 


Il UDP 这 三 种 协议 实现 数据 传输 。 在 传输 网 络 
实现 数据 的 交互 。 在 这 个 传输 过 程 
个 中 地 址 和 一 个 端 
ava 是 Andord 应 用 开发 的 主流 语言 ， 所 以 
用 Socket 实现 通信 的 基础 知识 。 


中 ， 通 常 将 
人 确定。 在 Java 


号 来 


a 


向 应 用 可 靠 的 或 非 可 靠 的 数据 传输 机 制 ， 


(5E Internet | 


上 的 一 


I B 
C KE 


rH 


IP 层 主要 负责 网 络 主机 的 定 
主机 。 而 TCP 层 则 提供 面 
网 络 编程 的 主要 对 象 。 目 前 较为 流行 的 网 络 编 


程 模型 是 客户 机 /服务 器 〈C/S) 结构 。 即 通信 双方 一 方 作为 服务 器 等 竺 客户 提出 请 求 ; 
响应 ;客户 则 在 需要 服务 时 向 服务 器 提出 申请 。 服 务 器 一 般 作 为 守护 进程 始终 运行 ， 


以 
监听 网 


络 端口 ， 一 旦 有 客户 请 求 ， 就 会 启动 一 个 服务 进程 来 响应 该 客户 ， 同 时 自己 继续 监听 服务 端 


口 ， 使 后 来 的 客户 也 能 及 时 得 到 服务 。 在 接 下 来 的 内 容 


本 知识 。 
5.1.1 TCP/IP 基础 


TCP/IP 是 Transmission Control Protocol/Internet Protocol 的 简写 ， 译 名 为 传输 控 人 
特 网 互联 协议 ， 又 名 网 络 通 信 协 议 ， 是 Internet 最 基本 的 协议 、Internet E 
网 络 层 的 IP 和 传输 层 的 TCP 组 成 。TCP/IP 定义 了 电子 设备 如 何 连 入 


何在 它们 之 间 传 输 的 标准 。TCP/IP 协议 采 月 


台 计 算 机 规定 一 个 地 址 。 


TCP/IP 不 是 TCP 和 IP 这 两 个 协议 的 合 称 ， 而 是 指 因 


议 分 层 模型 方面 来 讲 ，TCP/IP 由 四 个 


用 


=] 


Zx o 


HESE TCP/IP 并 不 完 


Ake 
全 符合 


OSI 


H 


的 七 


Hr 


层次 组 成 ， 分 别 是 网 络 接 


ZB, 


统 的 开放 式 系统 互联 参考 模型 ， 
REEN 


FE 


E 务 。 该 模型 的 目的 是 使 各 利 


NL 


Hift TCP/IP 和 UDP 的 基 


El HU P] 
际 互联 网 络 的 基础 ， 
因特网 ， 以 及 数据 如 


四 层 的 层级 结构 ， 每 


慨 都 呼叫 它 的 下 一 层 所 


提供 的 协议 来 完成 自己 的 需求 。 也 就 是 说 ，TCP 负责 发 现 传输 的 问题 ， 一 旦 发 现 问题 便 发 出 
信号 要 求 重 新 传输 ， 直 到 所 有 数据 安全 正确 地 传输 到 目的 地 。 而 卫 的 功能 是 给 


因特网 的 每 一 


特 网 整个 TCP/IP 协议 族 。 从 协 


层 、 网 络 层 、 传 输 层 、 应 


OSI (Open System Interconnect) 是 传 
种 通信 协议 的 七 层 抽象 的 参考 模型 ， 其 中 
硬件 在 相同 的 层次 上 可 以 相互 通信 ， 这 七 


每 一 层 执行 某 
AAA: 物 


Android 网 络 开 发 从 入 门 到 精通 


LE 层 、 数 据 链 路 


E (äs 


应 用 层 。 而 TCP/IP XH 
己 的 需求 。 


层 )、 网 络 层 〈 网 络 


目 了 四 层 的 层级 结构 ， 每 


T TCP/IP 的 设计 者 注 村 


的 或 是 将 来 有 的 各 种 协议 ， 所 以 这 个 


通 


过 网 络 接口 层 连接 到 任何 网 络 - 


5.1.2 UDP 
UDP 是 User Datagram Protocol 的 简称 ， 是 一 种 无 连接 的 协议 ， 每 个 数据 报 都 是 一 个 独立 


的 信 ， 


AR 


=| 


rary 


， 包 括 完整 的 源 地 址 或 


f Wb 


达 目 的 地 、 到 达 目 的 地 的 时 间 以 


EUR 


都 需要 不 定 长 度 的 数据 被 可 靠 地 传输 。 但 是 可 靠 的 传输 
计算 机 的 处 到 因此 TCP 传输 的 效率 不 如 UDP 高 。 
FRA 
这 种 情况 下 使 有 


的 地 址 ， 它 在 


72 


KARKE 


在 现实 网 络 数据 传输 过 程 


一 


D 
O 


TCP 的 主要 特点 如 下 。 


需要 连接 时 间 。 


O 面向 连接 的 协议 ， 在 socket 之 间 进 行 数据 传输 之 前 必然 


O TCP 传输 数据 大 小 限制 ， 


大 的 数据 。 
O TCP 是 一 个 可 靠 的 协议 ， 它 而 
UDP 的 主要 特点 如 下 。 


收 方 。 


在 日 常 应 月 


口 每 个 数据 报 中 都 给 出 了 完整 的 地 址 信息 ， 
O UDP 传输 数据 时 是 有 大 小 限 
口 UDP 是 一 个 不 可 靠 的 协议 , 发 送 方 所 发 送 的 数据 


中 ， 可 以 根据 如 下 两 点 来 选择 使 用 明 


外 保 接 收 方 完 全 正确 


PRECES 
层 都 呼叫 它 的 下 一 层 所 提供 的 网 络 来 完成 自 
的 是 网 络 互联 ， 人 允许 通信 子 网 〈 
层次 中 没有 提供 专门 的 1 
FEF， 例如 XX.25 交换 网 或 IEEE 802 


网 络 上 以 任何 可 能 的 路 径 传 往 


层 〈 传 输 层 )、 会 话 层 、 


表示 层 和 


网 络 接口 层 ) 采用 已 有 
HN. EERE, TCP/IP 协议 可 以 


H 的 地 ， 


因此 能 


上 性 都 是 不 能 被 保证 的 。 
， 大 多 数 功 能 是 由 TCP 和 UDP 实现 ， 在 接 下 来 的 内 容 中 ， 
F 述 两 种 协议 的 主要 特点 ， 以 便 读者 可 以 区 分 这 两 种 数据 传输 协议 。 


建立 连接 ， 所 以 在 TCP H 


旦 连接 建立 起 来 ,双方 的 socket 就 可 以 按 统一 的 格式 传输 


地 获取 发 送 方 所 发 送 的 全 部 数据 。 


因此 无 需要 建立 发 送 方 和 接收 方 的 连接 。 
剖 的 ， 每 个 被 传输 的 数 ] 


据 报 必须 限定 在 64KB 之 内 。 
及 并 不 一 定 以 相同 的 次 序 到 达 接 


一 种 传输 协议 。 


(1)TCP 在 网 络 通信 上 有 极 强 的 生命 力 ,例如 远程 连接 协议 (Telnet) 和 文件 传输 协议 (FTP) 


时 间 和 网 络 的 带宽 ， 


(2) UDP 操作 简单 ， 而 且 


P. Iam 
H UDP 会 


更 合理 一 些 。 


需要 较 少 的 监护 ， 


页 会 议 系统 ， 并 不 要 求 音 


是 对 数据 内 容 正 确 性 的 检验 必然 


占用 


因此 通常 月 


5.1.3 基于 Socket 的 Java 网 络 编程 


Socket. Socket 通常 月 
数据 传输 方式 ， 一 个 Socket 由 一 个 IP Hah 
议 种 类 也 不 4 


要 


网 络 上 的 两 个 程序 通过 


"a 


E TCP/IP 一 种 ， 
是 指 基于 TCP/IP 的 网 络 编程 。 
1. Socket 通信 的 过 程 


日 来 实现 客户 端 和 服务 端的 连接 


因此 两 者 之 让 


上 和 一 个 端 


昌 于 对 传输 可 靠 性 要 求 低 的 应 用 程 


频 视 频数 据 绝对 的 正确 ， 只 要 保证 连贯 性 就 可 以 了 ， 


个 双向 的 通讯 连接 实现 数据 的 交换 ， 双 向 链 路 的 一 端 称 为 一 个 
o Socket 是 TCP/IP 中 的 一 个 十 分 流行 的 
号 唯一 确定 。 但 是 ，Socket 所 支持 的 协 
是 没有 必然 联系 的 。 在 Java 环境 下 ，Socket 编程 主 


Server (HRSS) m Listen CHU 某 个 端口 是 否 有 连接 请 求 ，Client (客户 ) 端 向 Server 端 
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发 出 Connect GRE) 请 求 ，Server 端 向 Client 端 发 回 Accept (接受) 消息 。 一 个 连接 就 建立 
起 来 了 。Server 端 和 Client 端 都 可 以 通过 Send, Write 等 方法 与 对 方 通信 。 
在 Java 网 络 编程 应 用 中 ， 对 于 一 个 功能 齐全 的 Socket 来 说 ， 其 工作 过 程 包含 如 下 的 基本 
WU. 

1) 创建 Socket。 

2) 打开 连接 到 Socket 的 输入 /输出 流 。 

3) 按照 一 定 的 协议 对 Socket 进行 读 / 写 操作 。 

4) 关闭 Socket。 

2. 创建 Socket 

在 Java 网 络 编程 应 用 中 , 在 包 java.net 中 提供 了 两 个 类 Socket 和 ServerSocket, 分 别 用 来 
表示 双向 连接 的 客户 端 和 服务 端 。 这 是 两 个 封装 得 非常 好 的 类 ， 其 中 包含 了 如 下 的 构造 方法 。 
QO) Socket(InetAddress address, int port). 
Socket(InetAddress address, int port, boolean stream). 
Socket(String host, int prot). 
Socket(String host, int prot, boolean stream). 


Socket(SocketImpl impl). 
Socket(String host, int port, InetAddress localAddr, int localPort). 
Socket(InetAddress address, int port, InetAddress localAddr, int localPort). 
ServerSocket(int port). 
ServerSocket(int port, int backlog). 
ServerSocket(int port, int backlog, InetAddress bindAddr). 

在 上 述 构造 方法 中 ， 人 参数 address, host 和 port 分 别 是 双向 连接 中 另 一 方 的 卫 地 址 、 主 机 
名 和 端口 号 ， 参 数 stream 指明 socket 是 流 Socket 还 是 数据 报 Socket， 参 数 localPort 表示 本 地 
主机 的 端口 号 ， 参 数 localAddr 和 bindAddr 是 本 地 机 器 的 地 址 〈ServerSocket 的 主机 地 址 )， 
参数 impl 是 Socket 的 父 类 , 既 可 以 用 来 创建 ServerSocket 又 可 以 用 来 创建 Socket. 参数 count 
则 表示 服务 端 所 能 文 持 的 最 大 连接 数 。 例 如 : 


Socket client = new Socket("127.0.01.", 80); 
ServerSocket server = new ServerSocket(80); 


OOOOOOOdodO 


注意 : 必须 小 心地 选择 端口 号 ， 每 一 个 端口 号 提供 一 种 特定 的 服务 ， 只 有 给 出 正确 的 端口 
号 ， 才 能 获得 相应 的 服务 。0 一 1023 的 端口 号 为 系统 所 保留 ， 例 如 HTTP 服务 的 端口 号 为 80， 
Telnet 服务 的 端口 号 为 21，FTP 服务 的 端口 号 为 23， 所 以 我 们 在 选择 端口 号 时 ， 最 好 选择 一 个 
大 于 1023 的 数 以 防止 发 生 冲 突 。 另 外 ， 在 创建 Socket 时 如 果 发 生 错 误 ， 将 产生 IOException, 
在 程序 中 必须 相应 地 作出 处 理 ， 在 创建 Socket 或 ServerSocket 必须 捕获 或 抛 出 异常 。 


5.2 TCP 编程 详解 


TCP/IP 是 一 种 可 靠 的 网 络 协议 ， 能 够 在 通信 的 两 端 各 建立 一 个 Socket， 从 而 在 通信 的 两 
端 之 间 形 成 网 络 虚 拟 链 路 。 一 旦 建立 了 虚拟 的 网 络 链 路 ， 两 端的 程序 就 可 以 通过 虚拟 链 路 进 
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"a 


行 通信 。Java 语言 对 TCP 网 络 
端口 ， 并 通过 Socket j^^] 
用 中 TCP 编程 的 基本 知识 ， 为 


5.24 使 用 ServietSocket 


通 


在 Java 程序 中 , 使 月 


AY I Be xe Us v 的 Socket 连接 ， 如 果 没 有 连接 则 
ServerSocket 中 包含 了 如 下 监听 客户 端 连 接 请 求 的 方法 。 


日 类 ServerSocket 接受 其 他 通 


信和 提供 了 FE 


Gm LO 流 进行 网 络 通 信 。 在 本 章 的 内 容 ! 
读者 步 入 本 章 后 面 的 Android 编程 打 


， 通 过 Socket 对 象 可 以 代表 两 端的 通信 
， 将 首先 详细 讲解 Java 应 


实体 的 连接 请 求 时 ， 对 象 ServerSocket 


口 Socket accept(): 如 果 接 收 到 一 个 客户 端 Socket 的 连接 请 求 ， 该 方法 将 返回 一 个 与 客 


户 端 Socket 对 应 的 Socket, e Wl ATK 
为 了 创建 ServerSocket 对 象 ，ServerSocket 类 为 我 们 提供 了 如 下 构造 器 。 


O ServerSocket(int port): 用 指定 的 端 
个 有 效 的 端口 整数 值 : 0 一 65535。 

口 ServerSocket(int port,int backlog): 增加 一 个 用 来 改变 连接 队列 长 度 的 参数 backlog。 

O ServerSocket(int port,int backlog,InetAddress localAddr): 在 机 器 存在 多 个 IP 地 址 


的 情况 下 ， 人 允许 通过 localAddr 这 个 参数 来 指定 将 ServerSocket 绑 定 
地 址 。 


直 处 于 等 待 状态 ， 


线程 也 被 阻塞 。 


port 创建 一 个 ServerSocket， 该 端口 应 该 是 有 一 


到 指定 的 IP 


当 使 用 ServerSocket 后 ， 需 要 使 用 ServerSocket 中 的 close(0) 方 法 关闭 该 ServerSocket。 在 


情 况 下 , 


Xon 


// 创 建 一 个 ServerSocket, 


， 所 以 可 以 通过 循环 来 不 断 地 调 月 


ServerSocket ss = new ServerSocket(30000); 


/采用 循环 不 断 接 受 来 自 


while (true) 
1 


// 每 当 接 受到 客户 端 Socket WBA, ARS s Yn t] I^ 


Socket s — ss.accept(); 


/下 面 就 可 以 使 


PR 


1 Socket 进行 通信 了 


E 一 个 Socket 


因为 服务 器 不 会 只 接受 一 个 客户 端 请 求 ， 而 是 会 不 断 地 接受 来 自 客户 端的 所 有 
H ServerSocket 中 的 accept0 方 法 ， 例 如 下 面 的 代码 。 


于 监听 客户 端 Socket 的 连接 请 求 


在 上 述 代 码 中 ， 创 建 的 ServerSocket 没有 指定 IP 地 址 ， 所 以 ServerSocket 会 绑 定 到 本 机 


默认 的 卫 地 址 。 在 代码 


上 的 端口 ， 主 要 是 为 了 避免 与 


5.2.2 ”使 用 Socket 


H 40000 作为 该 ServerSocket 的 端 


在 客户 端 可 以 使 用 Socket 构造 器 实现 和 指定 服务 器 的 连接 , 在 Socket H 


两 个 构造 器 。 


O Socket(InetAddress/String remoteAddress, int port): 创建 连接 到 指定 远 包 
的 Socket， 该 构造 器 没有 指定 本 地 地 址 和 本 地 端口 ， 两 个 参数 默认 使 月 


120 EI 


其 他 应 用 程序 的 通用 站 


E 荐 使 用 10000 以 


以 使 用 如 下 的 


主机 、 远 程 端 


昌 本 地 主机 的 


默认 IP 地 址 和 系统 动态 指定 的 IP 地 址 。 
QO) Socket(InetA ddress/String remoteAddress, int port, InetAddress localA ddr, int localPort): 
创建 连接 到 指定 远程 主机 、 远 程 端口 的 Socket， 并 指定 本 地 IP 地 址 和 本 地 端口 号 , 适 
用 于 本 地 主机 有 多 个 IP 地 址 的 情形 。 
在 使 用 上 述 构造 器 指定 远程 主机 时 ， 既 可 使 用 InetAddress 来 指定 ， 也 可 以 使 


象 指 定 ， 在 Java 中 通常 使 用 String 对 象 指定 远 程 P， 例 如 192.168.2.23 。 当 本 地 主机 只 有 
个 PP 地 址 时 ， 
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用 String 对 


建议 使 用 第 一 个 方法 ， 第 一 个 方法 更 简单 ， 例 如 下 面 的 代码 。 


/创建 连接 到 本 机 、30000 端口 的 Socket 
Socket s = new Socket("127.0.0.1" , 30000); 


当 程 序 执行 上 述 代 码 后 会 连接 到 指定 服务 器 ， 服 务 器 端的 ServerSocket 的 accept) WIE 
下 执行 ， 于 是 服务 器 端 和 客户 端 就 产生 了 一 对 互相 连接 的 Socket。 上 述 代码 连接 


BL” AY IP 地址 是 127.0.0.1, Jk IP 地址 总 是 代表 本 机 的 IP 地 址 。 因 为 编者 示例 程 


端 、 客 户 端 都 是 在 本 机 中 运行 ， 所 以 Socket 连接 到 远程 主机 的 人 P 地 址 使 用 127.0. 
当 客 户 端 、 服 务 器 端 产 生 对 应 的 Socket 之 后 ， 程 序 无 须 再 区 分 服务 器 端 和 客 


通过 各 自 的 Socket 进行 通信 。 在 Socket 中 提供 如 下 两 个 方法 获取 输入 流 和 输出 流 。 
O InputStream getInputStream(): 返回 该 Socket 对 象 对 应 的 输入 流 ， 让 程序 通过 
从 Socket 中 取出 数据 。 
口 OutputStream getOutputStream(): 返回 该 Socket 对 象 对 应 的 输出 流 ， 让 程 
出 流向 Socket 中 输出 数据 。 


到 “远程 主 
序 的 服务 器 
0.1。 


例如 下 面 是 一 段 TCP 的 服务 器 端 程序 。 
源 但 路 径 : daima\5\tcpudp\src\Server.java 


import java.net.*; 


import java.io.*; 


public class Server 


1 


public static void main(String[] args) 


throws IOException 


1 


/创建 一 个 ServerSocket， 用 于 监听 客户 端 Socket 的 连接 请 求 
ServerSocket ss = new ServerSocket(30000); 


IA 


循环 不 断 接受 来 自 客户 端的 请 求 


while (true) 


{ 


// 每 当 接 受到 客户 端 Socket 的 请 求 ， 服 务 器 端 也 对 应 产生 一 个 Socket 
Socket s = ss.accept(); 

// 将 Socket 对 应 的 输出 流 包装 成 PrintStream 

PrintStream ps = new PrintStream(s.getOutputStream()); 

/进行 普通 TO 操作 

ps.println(" 圣 诞 快 乐 ! "); 

/关闭 输出 流 ， 关 闭 Socket 

ps.close(); 


户 端 ， 而 是 


十 该 输入 流 


序 通过 该 输 
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s.close(); 


通过 上 述 代码 建立 了 ServerSocket 监听 ， 并 且 使 用 Socket 获取 了 输出 流 ， 所 以 执行 后 不 
会 显示 任何 信息 。 

而 下 面 是 一 段 TCP 的 客户 端 程序 。 

源码 路 径 : 光盘 :\daima\5\tcpudp\src\Client.java 


import java.net.*; 
import java.io. *; 
public class Client 
{ 
public static void main(String[] args) 
throws IOException 
{ 
Socket socket = new Socket("127.0.0.1" , 30000); 
// 将 Socket 对 应 的 输入 流 包装 成 BufferedReader 
BufferedReader br = new BufferedReader( 
new InputStreamReader(socket.getInputStream())); 
/进行 普通 IO 操作 
String line = br.readLine(); 
System.out.println(" 来 自 服务 器 的 数据 : "+ line); 
/关闭 输入 流 、socket 
br.close(); 
socket.close(); 


上 述 代 码 使 用 Socket 建立 了 与 指定 卫 、 指 定 端口 的 连接 ， 并 使 用 Socket 获取 输入 流 读 取 
数据 。 执 行 后 的 效 末 如 图 5-1 所 示 。 


区 Froblems | @ Javadoc IS Declaration 
<terminated> Client [Java Application] : 


来 目 服务 器 的 数据 ， 圣诞 快乐 ! 


图 5-1 执行 效果 


由 此 可 见 ， 一 旦 使 用 ServerSocket 和 Socket 建立 网 络 连 接 之 后 ， 程 序 通过 网 络 通信 和 与 普 
通 IO 并 没有 太 大 的 区 别 。 如 果 先 运行 上 面 程 序 中 的 Server 类 ， 将 看 到 服务 器 一 直 处 于 等 待 
状态 ， 因 为 服务 器 使 用 了 死 循 环 来 接受 来 自 客户 端的 请 求 ， 再 运行 Client 类 ， 将 可 看 到 程序 
输出 :“ 来 自 服务 器 的 数据 : 圣诞 快乐 !”， 这 表明 客户 端 和 服务 器 端 通信 和 成功。 上 述 代码 为 了 

通过 ServerSocket 和 Socket 建立 连接 、 并 通过 底层 VO 流 进 行 通信 的 主题 ， 程 序 没 有 进 
常 处 理 ， 也 没有 使 用 finally 块 来 关闭 资源 。 
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5.2.3 TOP 中 的 多 线程 


在 本 章 5.2.2 的 实例 中 ，Server 和 Client 只 是 进行 了 简单 的 通信 操作 ， 当 服务 器 接收 到 客 


户 端 连接 之 后 ， 服 务 器 向 客户 端 输出 一 个 字符 串 ， 而 客户 端 也 只 是 读 取 服 务 器 的 


"e 


退出 了 。 在 实际 应 用 ， 


入 数据 。 


户 端 进行 通信 。 另 外 ， 


D 


SAY 


字符 串 后 就 


， 客 户 端 可 能 需要 和 服务 端 保持 长 时 间 通信 ， 即 服务 器 需要 不 断 地 读 
取 客户 端 数据 ， 并 向 客户 端 写 入 数据 ， 客 户 端 也 需要 不 断 地 读 取 服 务 器 数据 ， 并 向 服务 器 写 
当 使 用 readLine( 方 法 读 取 数据 时 ， 如 果 在 该 方法 成 功 返 回 之 前 线程 被 阻塞 ， 则 程序 无 法 
继续 执行 。 所 以 此 服务 器 很 有 必要 为 每 个 Socket 单独 启动 一 条 线程 ， 每 条 线程 负责 与 一 个 客 
因为 客户 端 读 取 服 务 器 数据 的 线程 同样 会 被 阻塞 ， 所 以 系统 应 该 单独 
启动 一 条 线程 ， 该 线程 专门 负责 读 取 服 务 器 数据 。 


假设 要 开发 一 个 聊天 室 程序 ， 在 服务 端 应 该 包含 多 个 线程 ， 其 中 每 个 Socket 对 应 一 个 线 
程 ， 该 线程 负责 读 取 Socket 对 应 输入 流 的 数据 〈 从 客户 端 发 送 过 来 的 数据 )， 并 将 读 到 的 数据 
向 每 个 Socket 输出 流 发 送 一 过 (将 一 个 客户 端 发 送 的 数据 “广播 ”给 其 


供 了 如 下 两 个 类 。 


O 创建 ServerSocket 监听 的 主 类 。 
口 处 理 每 个 Socket 通信 的 线程 类 。 
接 下 来 介绍 具体 实现 流程 ， 首 先 看 下 面 的 一 段 代码 。 


Wit: daima\5\tcpudp\src\liao\server\IServer.java 


package liao.server; 
import java.net.*; 
import java.io.*; 
import java.util.*; 
public class IServer 


1 


/定义 保存 所 有 Socket DÉI ArrayList 
public static ArrayList<Socket> socketList = new ArrayList<Socket>(); 
public static void main(String[] args) 


throws IOException 


1 


ServerSocket ss = new ServerSocket(30000); 


while(true) 
1 


/此 行 代 码 会 阻塞 ， 将 一 直 等 待 别人 的 连接 


Socket s = ss.accept(); 


socketList.add(s); 
// 每 当 客 户 端 连接 后 启动 一 条 ServerThread 线程 为 该 客户 端 服务 


new Thread(new Serverxian(s)).start(); 


他 客户 端 )， 


因此 需要 


在 服务 端 使 用 列表 List) 来 保存 所 有 的 Socket。 在 具体 实现 这 个 聊天 室 程序 时 ， 为 服务 器 提 
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在 上 述 代 码 中 ， 服 务 端 只 负责 接受 客户 端 Socket 的 连接 请 求 ， 每 当 客 户 端 Socket 连接 到 
该 ServerSocket 之 后 ， 程 序 将 对 应 Socket 加 入 socketList 集合 中 保存 ， 并 为 该 Socket 启动 一 
个 线程 ， 该 线程 负责 处 理 该 Socket 所 有 的 通信 任务 。 
然后 看 服务 端 线程 类 文件 的 主要 代码 。 


源码 路 径 : daima\5\tcpudp\src\liao\server\Serverxian.java 


/负责 处 理 每 个 线程 通信 的 线程 类 
public class Serverxian implements Runnable 


1 


/定义 当前 线程 所 处 理 的 Socket 

Socket s = null; 

/该 线程 所 处 理 的 Socket 所 对 应 的 输入 流 
BufferedReader br = null; 

public Serverxian(Socket s) 


throws IOException 


this.s = s; 

/初始 化 该 Socket 对 应 的 输入 流 

br = new BufferedReader(new InputStreamReader(s.getInputStream())); 
j 
public void run() 
{ 

try 

{ 


String content = null; 
/采用 循环 不 断 从 Socket 中 读 取 客 户 端 发 送 过 来 的 数据 
while ((content = readFromClient()) != null) 


{ 


/遍历 socketList 中 的 每 个 Socket, 
/将 读 到 的 内 容 向 每 个 Socket 发 送 一 次 
for (Socket s : IServer.socketList) 


1 


PrintStream ps — new PrintStream(s.getOutputStream()); 
ps.printIn(content); 


} 
catch (IOException e) 


{ 
//e.printStackTrace(); 


j 
/定义 读 取 客户 端 数据 的 方法 
private String readFromClient() 


1 


try 
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1 
return br.readLine(); 
j 
/如 果 捕 捉 到 异常 ， 表 明 该 Socket 对 应 的 客户 端 已 经 关闭 
catch (IOException e) 
{ 
// 删 除 该 Socket. 
IServer.socketList.remove(s); 
} 
return null; 


在 上 述 代码 中 ， 服 务 端 线程 类 会 不 断 读 取 客 户 端 数据 ， 在 获取 时 使 用 readFromClient()77 


法 来 读 取 客 户 端 数据 。 如 果 读 取 数 据 过 程 中 


B3Kfi IOException 异常 ， 则 说 明 此 Socket 对 应 


的 客户 端 Socket 出 现 了 问题 ， 程 序 就 会 将 此 Socket 从 socketList 中 删除 。 当 服务 线程 读 到 客 


户 端 数据 之 后 会 


遍历 整个 socketList 集合 ， 并 将 1 


玄 数 据 向 socketList 集合 中 的 每 个 Socket 发 送 


一 次 ， 该 服务 线程 将 把 从 Socket 中 读 到 的 数据 向 socketList 中 的 每 个 Socket 转发 一 次 。 


接 下 来 开始 客户 端的 编码 工作 ， 在 本 应 用 程序 的 每 个 客户 端 中 应 该 包含 如 下 两 个 线程 。 


a 第 二 个 : 


这 些 数据 打印 输出 。 其 中 负责 读 取 月 


: 功能 是 读 取 用 户 的 键盘 输入 ， 


并 将 用 户 输入 的 数据 写 入 Socket 对 应 的 输 


功能 是 读 取 Socket 对 应 输入 流 中 的 数据 (从 服务 器 发 送 过 来 的 数据 )， 并 将 


序 的 主线 程 负责 。 
客户 端 主 程序 文件 的 主要 代码 如 下 。 
源码 路 径 : daima\s\tcpudp\src\liao\server\Iclient.java 


public class IClient 


1 


public static void main(String[] args) 


throws IOException 


1 


Socket s = s = new Socket("127.0.0.1" , 30000); 


/客户 端 


启动 ClientThread 线程 不 断 读 取 来 自 


new Thread(new ClientThread(s)).start(); 


/获取 该 


Socket 对 应 的 输出 流 


上 户 键盘 输入 的 线程 由 Myclient 负责 ， 也 就 是 由 程 


服务 器 的 数据 


PrintStream ps = new PrintStream(s.getOutputStream()); 


String line = null; 
WAS SEL A. 


BufferedReader br = new BufferedReader(new InputStreamReader(System.in)); 


while ((line = br.readLine()) != null) 


{ 


// 将 用 户 的 键盘 输入 内 容 写 入 Socket 对 应 的 输出 流 
ps.printIn(line); 
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j 


在 上 述 代 码 中 ， 当 线程 读 到 用 户 键盘 输入 的 内 容 后 ， 会 将 用 户 键 盘 输入 的 内 容 写 入 该 
Socket 对 应 的 输出 流 。 当 主线 程 使 用 Socket 连接 到 服务 器 之 后 ， 会 启动 ClientThread 来 处 理 
该 线程 的 Socket 通信 。 

最 后 编写 客户 端的 线程 处 理 文件 ， 此 线程 负责 读 取 Socket 输入 流 中 的 内 容 ， 并 将 这 些 内 
容 在 控制 台 打 印 出 来 。 有 具体 代码 如 下 。 

源码 路 径 : daima\5\tcpudp\src\liao\server\Clientxian. java 


T 


public class Clientxian implements Runnable 


1 
/该 线程 负责 处 理 的 Socket 
private Socket s; 
/该 现成 所 处 理 的 Socket 所 对 应 的 输入 流 
BufferedReader br = null; 
public Clientxian(Socket s) 
throws IOException 
{ 
this.s = s; 
br = new BufferedReader( 
new InputStreamReader(s.getInputStream())); 
} 
public void run() 
1 
try 
{ 
String content = null; 
// 不 断 读 取 Socket 输入 流 中 的 内 容 ， 并 将 这 些 内 容 打印 输出 
while ((content = br.readLine()) != null) 
1 
System.out.println(content); 
} 
} 
catch (Exception e) 
1 
e.printStackTrace(); 
} 
} 
} 


上 述 代码 能 够 不 断 获取 Socket 输入 流 中 的 内 容 ， 当 获取 Socket 输入 流 中 的 内 容 后 ， 直 接 
将 这 些 内 容 打印 在 控制 台 。 先 运行 上 面 程 序 中 的 IServer 类 ， 该 类 运行 后 作为 本 应 用 程序 的 服 
务 器 ， 不 会 得 到 任何 输出 。 接 着 可 以 运行 多 个 IClient 一 一 相当 于 多 个 聊天 室 客 户 端 登录 该 服 
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务 器 ， 此 时 可 以 看 到 在 任何 一 个 客户 端 通过 键盘 输入 一 EUR a 
所 有 客户 端 〈 包 括 自己 ) 都 会 在 控制 台 收 到 他 刚刚 输入 的 内 容 ， 这 


的 功能 
5.2.4 实现 非 阻 塞 $0cket 通信 


在 Java 应 用 程序 中 ， 可 以 使 用 NIO (New I/O) API 来 开发 高 性 能 
行 输入 、 输 出 操作 后 ， 在 这 些 操作 返回 之 前 会 一 直 阻 塞 该 线程 ， 
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(Enter〉 键 ， 将 可 看 到 


里 大 量 客户 端 请 求 时 ， 这 种 做 法 会 降低 性 能 


(1) Selector: 是 SelectableChannel 对 象 的 多 路 复 用 器 ， 所 有 希望 采用 非 阻塞 方式 进行 通 


在 Java 应 用 程序 中 可 以 用 NIO API 使 服务 器 提供 一 个 或 有 限 几 个 线程 来 同时 处 理 连接 到 
服务 器 上 的 所 有 客户 端 。 在 Java 的 NIO 中 ， 为 非 阻 塞 式 的 Socket 通信 提供 了 下 面 的 特殊 类 。 


就 简单 实现 了 一 个 聊天 室 


网 络 服务 器 。 当 程序 执 


服务 器 必须 为 每 个 客户 端 都 
提供 一 个 独立 线程 进行 处 理 。 这 说 明 前 面 的 程序 是 基于 阻塞 式 API 的 ， 当 服务 器 需要 同时 处 


信 的 Channel 都 应 该 注册 到 Selector 对 象 。 可 通过 调用 此 类 的 静态 open0 方 法 来 创建 Selector 
实例 ， 该 方法 将 使 用 系统 默认 的 Selector 来 返回 新 的 Selector. Sele 
SelectableChannel 的 VO 状况 ,是非 阻塞 IO 的 核心 ,一 个 Selector 实例 有 如 下 3 个 SelectionKey 


的 集合 。 


ctor 可 以 同时 监控 多 个 


O 所 有 SelectionKey 424: 代表 了 注册 在 该 Selector 上 的 Channel， 这 个 集合 可 以 通过 


keys(0) 方 法 返回 。 


口 被 选择 的 SelectionKey 集合 : 代表 了 所 有 可 通过 select(0 方 法 监测 到 、 需 要 进行 IO 处 


理 的 Channel， 这 个 集合 可 以 通过 selectedKeys0 方 法 返回 。 


O 被 取消 的 SelectionKey 424: 代表 了 所 有 被 取消 注册 关系 的 Channel， 在 下 一 次 执行 
select0 方 法 时 ， 这 些 Channel 对 应 的 SelectionKey 会 被 彻底 删除 ， 程 序 通常 无 须 直 接 


访问 该 集合 。 


除 此 之 外 ，Selector 还 提供 了 如 下 和 select0 相 关 的 方法 。 


T int select): 监控 所 有 注册 的 Channel, EM] 


A rs BE Ah 


的 VO 操作 时 ， 该 方法 


返回 ， 并 将 对 应 的 SelectionKey 加 入 被 选择 的 SelectionKey 集合 中 ， 该 方法 返回 这 些 


Channel 的 数量 。 


口 int select(long timeout): 可 以 设置 超时 的 selectO 操 作 。 
口 int selectNow0: 执行 一 个 立即 返回 的 select0 操 作 ， 相 对 于 无 参数 的 select0 方 法 而 言 ， 


该 方法 不 会 阻塞 线程 。 


O Selector wakeup): 使 一 个 还 未 返回 的 select0 方 法 立刻 返回 。 


(2) SelectableChannel: 它 代表 可 以 支持 非 阳 塞 IO 


操作 的 Channel 对 象 ， 可 以 将 其 注册 


到 Selector E, 这 种 注册 的 关系 由 SelectionKey 实例 表示 ,在 Selector 对 象 中 , 可 以 使 用 select() 
方法 设置 允许 应 用 程序 同时 监控 多 个 WO Channel. Java 程序 可 调用 SelectableChannel 中 的 


register() 方 法 将 其 注册 到 指定 Selector E, 41% Selector 4 
里 的 VO 操作 时 ， 程 序 可 以 调用 Selector 实例 的 select0 方 法 
selectedKeys(0) 方 法 返回 它们 对 应 的 SelectKey 集合 。 这 个 集合 的 作用 


可 以 获取 所 有 需要 处 理 IO 操作 的 SelectableChannel 集 。 


P 某 些 SelectableChannel 上 有 需要 处 
以 获取 它们 的 数量 ， 并 通过 
巨大 ， 因 为 通过 该 集合 就 


对 象 SelectableChannel 支持 阻塞 和 非 阻 塞 两 种 模式 ， 其 中 所 有 Channel 默认 都 是 阻塞 模 
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式 ， 我 们 必须 使 用 非 阻 塞 式 模式 才 可 以 利用 非 阻 塞 IO 操作 。 
在 SelectableChannel 中 提供 了 如 下 两 个 方法 来 设置 和 返回 该 Channel 的 模式 状态 。 
O SelectableChannel configureBlocking(boolean block): 设置 是 否 采 用 阻塞 模式 。 
口 boolean isBlocking(): 返回 该 Channel 是 否 是 阻塞 模式 。 
不 同 的 SelectableChannel 所 文 持 的 操作 不 一 样 ， 例 如 ServerSocketChannel 代表 一 个 
ServerSocket， 它 就 只 支持 OP_ACCEPT 操作 。 在 SelectableChannel 中 提供 ValidOps0 方 法 返 
回 一 个 bit mask， 表 示 这 个 channel 上 支持 的 IO 操作 来 返回 它 支 持 的 所 有 操作 。 


除 此 之 外 ，SelectableChannel 还 


提供 了 如 下 方法 获取 它 的 注册 状态 。 


O boolean isRegistered(): 返回 该 Channel 是 否 已 注册 在 一 个 或 多 个 Selector 上 。 

口 SelectionKey keyFor(Selector sel): 返回 该 Channel 和 Selector 之 间 的 注册 关系 ， 如 
不 存在 注册 关系 ， 则 返回 null。 
O SelectionKey: 该 对 象 代表 SelectableChannel 和 Selector 之 间 的 注册 关系 。 
O ServerSocketChannel: 支持 非 阻塞 操作 ， 对 应 于 java.net.ServerSocket 类 ， 提 供 了 TCP 


ES 


协议 VO 接口 ， 只 支持 OP ACCEPT 操作 。 该 类 也 提供 了 accept0 方 法 ， 功 能 相当 于 
ServerSocket 提供 的 accept0 方 法 。 
O SocketChannel: 支持 非 阻 塞 操作 ， 对 应 于 java.net.Socket 类 ， 提 供 了 TCP 协议 IO 


SocketChannel 来 读 写 ByteBuffer 对 象 。 


iX Selector 上 有 多 少 个 Channel 具有 可 用 的 


Channel 对 应 的 SelectionKey 集合 。 正 是 通过 Selector 才 使 和 


实例 的 select0 方 法 , 这 样 就 可 以 4 


上 注册 的 所 有 Channel 都 没有 需要 处 理 


该 方法 的 线程 被 阻塞 。 


视 这 些 Socket 的 IO 状态 , 当 其 中 从 


服务 器 上 的 所 有 Channel 都 需要 向 Selector 注册 ， 包 插 ServerSocketChannel 


SocketChannel。 该 Selector 则 负责 监 


接 


,支持 OP CONNECT, OP READ 和 OP_ WRITE 操作 。 这 个 类 还 实现 了 ByteChannel 
接口 、ScatteringByteChannel 接口 和 GatheringByteChannel 接口 ， 所 以 可 以 直接 通 i 


过 


和 


E 意 一 个 或 多 个 Channel 


具有 可 用 的 VO 操作 时 ， 该 Selector 的 select0) 方 法 将 会 返回 大 于 0 的 整数 ， 该 整数 值 就 表 


示 


IO 操作 , 并 提供 了 selectedKeys(0) 方 法 来 返回 这 些 


导 服务 端 只 需要 不 断 地 调用 Selector 


S 


HIE Zäg PT Channel 是 否 有 需要 处 理 的 VO 操作 。 当 Selector 


的 LO 操作 时 ， 将 会 阻塞 select0 方 法 ， 此 时 调用 


我 们 继续 以 聊天 室 为 例 ， 讲 解 非 阻 塞 Socket 通信 在 Java 应 用 项 目 中 的 实现 过 程 。 我 们 


目标 是 ， 在 服务 端 使 用 循环 不 断 地 获取 Selector 的 select0 方 法 返回 值 ， 当 该 返回 值 大 于 0 


就 处 理 该 Selector 上 被 选择 SelectionKey 所 对 应 的 Channel。 在 具体 实现 时 ， 服 务 端 使 


的 
时 
用 


ServerSocketChannel 来 监听 客户 端的 连接 请 求 ， 程 序 先 调用 它 的 socket0 方 法 获得 关联 


ServerSocket 对 象 ， 再 用 该 ServerSocket 对 象 绑 定 到 指定 监听 的 IP 和 端口 。 最 后 在 服务 端 


用 Selector 的 select0 方 法 来 监听 所 有 Channel 上 的 IO 操作 。 


II 


接 下 来 开始 具体 编码 ， 


服务 端的 了 


要 代码 如 下 。 


源 但 路 径 : daima\5\tcpudp\src\feizu\feizuServer.java 


public class feizuServer 


1 


/用 于 检测 所 有 Channel 状态 的 Selector 


private Selector selector = null; 
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/定义 实现 编码 、 解 码 的 字符 集 对 象 
private Charset charset = Charset.forName("UTF-8"); 
public void init()throws IOException 
{ 
selector = Selector.open(); 
// 通 过 open 方法 来 打开 一 个 未 绑 定 的 ServerSocketChannel 实例 
ServerSocketChannel server = ServerSocketChannel.open(); 
InetSocketAddress isa = new InetSocketAddress( 
"127.0.0.1", 30000); 
/将 该 ServerSocketChannel 472 #457 IP 地 址 
server.socket().bind(isa); 
/设置 ServerSocket 以 非 阻塞 方式 工作 
server.configureBlocking(false); 
/将 server 注册 到 指定 Selector 对 象 
server.register(selector, SelectionKey.OP ACCEPT); 
while (selector.select() > 0) 


1 


/依次 处 理 selector 上 的 每 个 已 选择 的 SelectionKey 
for (SelectionKey sk : selector.selectedKeys()) 
{ 


// 从 selector 上 的 已 选择 Key 集中 删除 正在 处 理 的 SelectionKey 
selector.selectedKeys().remove(sk); 

// 如 果 sk 对 应 的 通道 包含 客户 端的 连接 请 求 

if (sk.isAcceptable()) 

{ 


// 调 用 accept 方法 接受 连接 ， 产 生 服 务 器 端 对 应 的 SocketChannel 
SocketChannel sc = server.accept(); 

/设置 采用 非 阻塞 模式 

sc.configureBlocking(false); 

// 将 该 SocketChannel 也 注册 到 selector 

sc.register(selector, SelectionKey.OP READ); 

/将 号 对 应 的 Channel 设置 成 准备 接受 其 他 请 求 
sk.interestOps(SelectionKey.OP_ACCEPT); 


} 

/如 果 蒲 对 应 的 通道 有 数据 需要 读 取 
if (sk.isReadable()) 

1 


/获取 该 SelectionKey 对 应 的 Channel, 1% Channel 中 有 可 读 的 数据 
SocketChannel sc = (SocketChannel)sk.channel(); 

/定义 准备 执行 读 取 数 据 的 ByteBuffer 

ByteBuffer buff = ByteBuffer.allocate(1024); 


— Oc 
, 


String content 


/开始 读 取 数据 
try 
{ 
while(sc.read(buff) > 0) 
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{ 
buff.flip(); 
content += charset.decode(buff); 
} 
// 打 印 从 该 sk 对 应 的 Channel 里 读 取 到 的 数据 
System.out.println("—— — — —" + content); 
/将 张 对 应 的 Channel 设置 成 准备 下 一 次 读 取 
sk.interestOps(SelectionKey.OP READ); 
} 
// 如 果 捕 捉 到 该 sk 对 应 的 Channel 出 现 了 异常 ， 即 表明 该 Channel 
// 对 应 的 Client 出 现 了 问题 ， 所 以 从 Selector 中 取消 sk 的 注册 
catch (IOException ex) 
{ 
// 从 Selector 中 删除 指定 的 SelectionKey 
sk.cancel(); 
if (sk.channel() != null) 
{ 
sk.channel().close(); 
} 
} 
/如 果 content 的 长 度 大 于 0， 即 聊天 信息 不 为 空 
if (content.length() > 0) 
1 
ITZ selector 里 注册 的 所 有 SelectKey 
for (SelectionKey key : selector.keys()) 
{ 
/获取 该 key 对 应 的 Channel 
Channel targetChannel = key.channel(); 
/如 果 该 channel 是 SocketChannel 对 象 
if (targetChannel instanceof SocketChannel) 
{ 
// 将 读 到 的 内 容 写 入 该 Channel 中 
SocketChannel dest = (SocketChannel)targetChannel; 
dest.write(charset.encode(content)); 
} 
} 
} 
} 
} 
} 
} 


public static void main(String[] args) 
throws IOException 


new feizuServer().init(); 
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通过 上 述 代 码 ， 可 在 启动 时 马上 建立 一 个 监听 连接 请 求 的 ServerSocketChannel， 并 将 该 


Channel 注册 到 指定 的 Selector， 接 着 程序 直接 采用 循环 方法 ， 不 断 地 监控 Selector 对 象 的 
select(0) 方 法 的 返回 值 ， 当 该 返回 值 大 于 0 时 处 理 该 Selector 上 所 有 被 选择 的 SelectionKey。 处 


里 指定 的 SelectionKey 之 后 立即 将 在 Selector 中 的 被 选择 的 SelectionKey 集合 中 删除 该 
SelectionKey。 服 务 端的 Selecto 仅 需 要 监听 连接 和 读数 据 这 两 种 操作 ， 在 处 理 连接 操作 时 上 只 


需 将 接受 连接 后 产生 的 SocketChannel 注册 到 指定 Selector 对 象 即 可 。 当 处 理 读 数据 操作 后 ， 
系统 先 从 该 Socket 中 读 取 数据 ， 再 将 数据 写 入 在 Selector 上 注册 的 所 有 Channel 中 。 


接 下 来 


始 编写 客户 端的 代码 ， 本 应 用 的 客户 端 程序 需要 如 下 两 个 线程 。 


口 负责 读 取 用 户 的 键盘 输入 ， 并 将 输入 的 内 容 写 入 SocketChannel 中 。 
O 不 断 查询 Selector 对 象 的 select0) 方 法 的 返回 值 。 

客户 端的 主要 代码 如 下 。 

Vite: daima\s\tcpudp\src\feizu\feizuClient.java 


public class feizuClient { 


UG XK 


| SocketChannel 的 Selector 对 象 


private Selector selector — null; 


/定义 处 至 


编码 和 解码 的 字符 集 


private Charset charset = Charset.forName("UTF-8"); 
/客户 端 SocketChannel 
private SocketChannel sc = null; 


public void init()throws IOException 


1 


selector = Selector.open(); 
InetSocketAddress isa = new InetSocketA ddress("127.0.0.1", 30000); 


// 调 


sc = 


用 open 静态 方法 创建 连接 到 指定 主机 的 SocketChannel 


SocketChannel.open(isa); 


/设置 该 sc 以 非 阻塞 方式 工作 


sc.configureBlocking(false); 


/将 


SocketChannel 对 象 注册 到 指定 Selector 


sc.register(selector, SelectionKey.OP_READ); 
/局 动 读 取 服 务 器 端 数据 的 线程 


new 


ClientThread().start(); 


/创建 键盘 输入 流 


Scanner scan = new Scanner(System.in); 


whil 
1 


e (scan.hasNextLine()) 


ERLE 
String line = scan.nextLine(); 
/将 键盘 输入 的 内 容 输出 到 SocketChannel 中 


sc.write(charset.encode(line)); 
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/定义 读 取 服 务 器 数据 的 线程 


private class ClientThread extends Thread 


1 


j 


public void run() 
{ 

try 

{ 


while (selector.select() > 0) 


1 


/遍历 每 个 有 可 用 IO 操作 Channel 对 应 的 SelectionKey 
for (SelectionKey sk : selector.selectedKeys()) 


1 


j 


/删除 正在 处 理 的 SelectionK ey 

selector.selectedK eys().remove(sk); 

/如 果 该 SelectionKey 对 应 的 Channel 中 有 可 读 的 数 j 
if (sk.isReadable()) 

{ 


// 使 用 NIO 读 取 Channel 中 的 数据 
SocketChannel sc = (SocketChannel)sk.channel(); 
ByteBuffer buff = ByteBuffer.allocate(1024); 
String content = ""; 
while(sc.read(buff) > 0) 
{ 

sc.read(buff); 

buff flip); 

content += charset.decode(buff); 
j 
AT ERAI E GD AY PAS 
System.out.println(" 聊 天 信息 : "+ content); 
/为 下 一 次 读 取 作 准 备 
sk.interestOps(SelectionKey.OP READ); 


catch (IOException ex) 


1 


ex.printStackTrace(); 


public static void main(String] args) 
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throws IOException 


new feizuClient().init(); 


DI 


程序 会 启动 另 一 条 线程 来 监测 该 Selector. 


SocketChannel, 


客 
如 
时 


5 


代 
9. 


在 使 用 NIO 来 实现 服务 器 时 ， 


上 述 客户 端 代码 只 有 一 条 SocketChannel， 当 此 SocketChannel 注册 到 指定 的 Selector 后 
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~ 


其 至 无 须 使 用 ArrayList 来 保存 服务 器 中 所 有 的 
因为 所 有 的 SocketChannel 都 需要 注册 到 指定 的 Selector 对 象 。 除 此 之 外 ， 当 


户 端 关 闭 时 会 导致 服务 器 对 应 的 Channel 也 抛 出 异常 ， 而 且 在 使 用 NIO 时 只 有 一 条 线程 ， 
果 该 异常 得 不 到 处 理 将 会 导致 整个 服务 器 退出 ， 所 以 程序 捕捉 了 这 种 异常 ， 并 在 处 理 异 常 


从 Selector 删除 异常 的 Channel E 


.3 UDP 编程 


Java 为 我 们 提供 了 DatagramSocket 对 象 作 为 基于 UDP 的 Socket, 可 以 使 用 DatagramPacket 


表 DatagramSocket 发 送 或 接收 的 数据 报 。 


34 使 用 DatagramSocket 


发 
功 


务 
M 


1% 


而 


建立 一 个 DatagramSocket 对 象 ， 月 


DatagramSocket 本 身 只 是 码头 ， 不 维护 状态 ， 不 能 产生 IO 流 ， 其 唯一 的 功能 是 接收 和 
送 数 据 报 。Java 语言 使 用 DatagramPacket 代表 数据 报 ，DatagramSocket 的 接收 和 发 送 数 据 


能 都 是 通过 DatagramPacket 对 象 实现 的 。 


在 DatagramSocket 中 有 如 下 三 个 构造 器 。 
口 DatagramSocket(): 负责 创建 一 个 DatagramSocket 实例 ， 并 将 该 对 象 绑 定 到 本 机 默认 


AY IP 地 址 、 本 机 所 有 可 用 端口 中 随机 选择 的 某 个 端 


口 DatagramSocket(int prot): 负责 创建 一 个 EE 实例 ， 并 将 该 对 象 绑 定 到 本 


机 默认 的 IP 地 址 、 指 定 的 端 


口 DatagramSocket(int port, InetAddress laddr): 负责 创建 一 个 DatagramSocket 实例 ， 并 将 
该 对 象 绑 定 到 指定 的 IP 地 址 、 指 定 的 端口 。 

在 Java 程序 中 ， 通 过 上 述 任意 一 个 构造 器 即 可 创建 一 个 DatagramSocket 实例 。 在 创建 服 

器 时 必须 创建 指定 端口 的 DatagramSocket 实例 ， 目 的 是 保证 其 他 客户 端 可 以 将 数据 发 送 到 


该 服务 器 。 一 旦 得 到 了 DatagramSocket 实例 ， 就 可 以 通过 下 面 的 两 个 方法 接收 和 发 送 数据 。 
口 receive(DatagramPacket p): 从 该 DatagramSocket 中 接收 数据 报 。 

C] send(DatagramPacket p): 以 该 DatagramSocket 对 象 向 外 发 送 数据 报 。 

在 使 用 DatagramSocket 发 送 数据 报时 ， 
是 由 DatagramPacket 决定 数据 报 的 去 处 。 
是 将 这 些 集装箱 发 送出 去 ， 而 集装箱 本 身 包 


DatagramSocket 并 不 知道 将 该 数据 报 发 送 到 何 处 ， 
就 像 码 头 并 不 知道 每 个 集装箱 的 目的 地 ， 人 码头 只 
含 了 该 集装箱 的 目的 地 。 


当 C/S 程序 使 用 UDP 时 ， 实 际 上 并 没有 明确 的 服务 器 和 客户 端 区 分 ， 因 为 双方 都 需要 先 


来 接收 或 发 送 数据 报 ， 然 后 使 用 DatagramPacket 对 象 作 为 


传输 数据 的 载体 。 通 常 固定 卫 、 固 定 端 口 的 DatagramSocket 对 象 所 在 的 程序 被 称 为 服务 器 ， 
为 该 DatagramSocket 可 以 主动 接收 客户 端 数据 。 
在 DatagramPacket 中 包含 了 如 下 常用 的 构造 器 。 


因 
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口 DatagramPacket(byte buf[],int length): 以 一 个 空 数 组 来 创建 DatagramPacket 对 象 ， 该 
对 象 的 作用 是 接收 DatagramSocket 中 的 数据 。 
口 DatagramPacket(byte buff], int length, InetAddress addr, int port): 以 一 个 包含 数据 的 数组 
来 创建 DatagramPacket 对 象 ， 创 建 该 DatagramPacket 时 还 指定 了 IP 地 址 和 端口 一 一 
这 就 决定 了 该 数据 报 的 目的 地 。 
L] DatagramPacket(byte[] buf, int offset, int length): 以 一 个 空 数组 来 创建 DatagramPacket 
对 象 ， 并 指定 接收 到 的 数据 放 入 buf 数组 中 时 从 offset 开始 ， 最 多 放 length 个 字 节 。 
口 DatagramPacket(byte[] buf, int offset, int length, InetAddress address, int port): 创建 一 个 
用 于 发 送 的 DatagramPacket 对 象 ， 也 多 指定 了 一 个 offset 参数 。 
在 接收 数据 前 ， 应 该 采用 上 面 的 第 一 个 或 第 三 个 构造 器 生成 一 个 DatagramPacket 对 象 ， 
给 出 接收 数据 的 字 节 数组 及 其 长 度 。 然 后 调用 DatagramSocket 中 的 receive0 方 法 等 待 数 据 报 
的 到 来 ， 此 方法 将 一 直 等 待 〈 阻 塞 调用 该 方法 的 线程 )， 直 到 收 到 一 个 数据 报 为 止 。 例 如 下 面 
的 代码 。 


/创建 接受 数据 的 DatagramPacket 对 象 
DatagramPacket packet=new DatagramPacket(buf, 256); 
/接收 数据 


socket.receive(packet); 


在 发 送 数 据 之 前 ， 调 用 第 二 个 或 第 四 个 构造 器 创建 DatagramPacket 对 象 ， 此 时 的 字 节 数 
组 里 存放 了 想 发 送 的 数据 。 除 此 之 外 ， 还 要 给 出 完整 的 目的 地 址 ， 包 括 IP 地 址 和 端口 号 。 发 
送 数据 是 通过 DatagramSocket 的 方法 send0 实 现 的 , 方法 send0 根 据 数据 报 的 目的 地 址 来 传递 
数据 报 。 例 如 下 面 的 代码 。 


/创建 一 个 发 送 数据 的 DatagramPacket 对 象 

DatagramPacket packet = new DatagramPacket(buf, length, address, port); 
/发 送 数据 报 

socket.send(packet); 


DatagramPacket 为 我 们 提供 了 getData0 方 法 ， 此 方法 可 以 返回 DatagramPacket 对 象 中 封 

闭 的 字 节 数组 。 
当 服 务 器 (也 可 以 为 客户 端 ) 接收 到 一 个 DatagramPacket 对 象 后 ， 如 果 想 向 该 数据 报 的 

发 送 者 “反馈 ”一 些 信息 ， 但 由 于 UDP 是 面向 非 连接 的 ， 所 以 接收 者 并 不 知道 每 个 数据 报 由 
谁 发 送 过 来 ,但 程序 可 以 调用 DatagramPacket 的 如 下 三 个 方法 来 获取 发 送 者 的 卫 和 端口 信息 。 
口 InetAddress getAddress0: 返回 某 台 机 器 的 IP 地址 ， 当 程序 准备 发 送 此 数据 报时 ， 该 
方法 返回 此 数据 报 的 目标 机 器 的 IP 地 址 ; 当 程 序 刚刚 接收 到 一 个 数据 报时 , 该 方法 返 

回 该 数据 报 的 发 送 主机 的 P 地 址 。 

T int getPort(): 返回 某 台 机 器 的 端口 ， 当 程序 准备 发 送 此 数据 报时 ， 该 方法 返回 此 数据 
报 的 目标 机 器 的 端口 ， 当 程序 刚刚 接收 到 一 个 数据 报时 ， 该 方法 返回 该 数据 报 的 发 送 
主机 的 端口 。 
口 SocketAddress getSocketAddress(): 返回 完整 的 SocketAddress, W% FH IP 地址 和 端口 
组 成 。 当 程序 准备 发 送 此 数据 报时 ， 该 方法 返回 此 数据 报 的 目标 SocketAddress; 当 程 
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序 刚刚 接收 到 一 个 数据 报时 ， 该 方法 返回 该 数据 报 的 源 SocketAddress . 
上 述 getSocketAddress 方法 的 返回 值 是 一 个 SocketAddress 对 象 ， 该 对 象 实际 上 就 是 一 个 


IP 地 址 和 一 个 端口 号 ， 也 就 是 说 SocketAddress 对 象 封装 了 一 个 InetAddress 对 象 和 一 个 代表 


At 


"fj 


的 整数 ， 所 以 使 用 SocketAddress 对 象 可 以 同时 代表 IP 地 址 和 端 
例如 下 面 是 一 段 实现 UDP 的 服务 端 代码 。 
源码 路 径 : daima\s\tcpudp\src\UdpServer.java 


public class UdpServer 


{ 


public static final int PORT = 30000; 
/定义 每 个 数据 报 的 最 大 大 小 为 4K 
private static final int DATA_LEN = 4096; 
/定义 该 服务 器 使 用 的 DatagramSocket 
private DatagramSocket socket = null; 
/定义 接收 网 络 数据 的 字 节 数组 
byte[] inBuff = new byte[DATA LEN]; 
/以 指定 字 节 数组 创建 准备 接受 数据 的 DatagramPacket X15 
private DatagramPacket inPacket = 

new DatagramPacket(inBuff , inBuff.length); 
/定义 一 个 用 于 发 送 的 DatagramPacket 对 象 
private DatagramPacket outPacket; 
/定义 一 个 字符 串 数组 ， 服 务 器 发 送 该 数组 的 元 素 
String[] books = new String[] 


{ 
"AAA", 
"BBB", 
"COOH 
"DDD" 
5 
public void init()throws IOException 
1 
try 
1 


// 创 建 DatagramSocket 对 象 

socket — new DatagramSocket(PORT); 
/采用 循环 接受 数据 

for (int i = 0; i < 1000 ; i ) 

1 


[us] 


// 读 取 Socket 中 的 数据 ， 读 到 的 数据 放 在 inPacket 所 封装 的 字 节 数组 里 。 
socket.receive(inPacket); 
/判断 inPacket.getData()#ll inBuff 是 否 是 同一 个 数组 
System.out.printIn(inBuff == inPacket.getData()); 
将 接收 到 的 内 容 转 成 字符 串 后 输出 
System.out.printIn(new String(inBuff , 
0 , inPacket.getLength())); 
// 从 字符 串 数 组 中 取出 一 个 元 素 作为 发 送 的 数据 


= 
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byte[] sendData = books[i % 4].getBytes(); 


// 以 指定 字 市 


数组 作为 发 送 数 据 、 以 刚 接受 到 的 DatagramPacket 的 


// 源 SocketAddress 作为 目标 SocketAddress 创建 DatagramPacket。 
outPacket = new DatagramPacket(sendData , 

sendData.length , inPacket.getSocketAddress()); 

/发 送 数据 


socket.send(outPacket); 


} 
j 
// 使 用 finally 块 保证 关闭 资源 
finally 
{ 
if (socket != null) 
{ 
socket.close(); 
} 
j 
j 
public static void main(String[] args) 
throws IOException 
1 
new UdpServer().init(); 
j 
j 
上 述 代码 使 


] DatagramSocket 实现 了 C/S 结构 的 网 络 通信 程序 ， 其 中 服务 端 使 用 1000 


次 循环 来 读 取 DatagramSocket 中 的 数据 报 ， 每 当 读 到 内 容 之 后 便 向 该 数据 报 的 发 送 者 送 回 一 


条 信息 GË 


接 下 看 客户 端的 实现 代码 ， 客 户 端 代码 与 服务 端 类 似 ， 也 是 采用 循环 ， 不 断 地 读 取 用 


户 键盘 输入 ,每 当 读 到 用 户 输入 内 容 后 


数据 报 发 送出 去 。 然 后 把 DatagramSocket 


际 上 是 读 入 该 DatagramPacket 所 封装 的 字 ? 


代码 。 


百 就 将 该 内 容 封 装 成 DatagramPacket 数据 报 ， 再 将 该 


中 的 数据 读 入 接收 用 的 DatagramPacket P (CK 
节 数 组 中 )。 例如 下 面 是 一 段 实现 UDP 的 客户 端 


源 但 路 径 : daima\5\tcpudp\src\UdpClient.java 


public class UdpClient{ 
/定义 发 送 数据 报 的 目的 地 
public static final int DEST PORT = 30000; 


public static final String DEST IP = "127.0.0.1"; 


/定义 每 个 数据 报 的 最 大 大 小 为 4K 
private static final int DATA_LEN = 4096; 


/定义 该 客户 端 


private DatagramSo 


re ML d £8 BY 


i BEF 


目的 DatagramSocket 


cket socket = null; 
居 的 字 节 数组 


byte[] inBuff = new byte[DATA LEN]; 
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/以 指定 字 节 数组 创建 准备 接受 数据 的 DatagramPacket X155 
private DatagramPacket inPacket = 
new DatagramPacket(inBuff , inBuff.length); 
/定义 一 个 用 于 发 送 的 DatagramPacket 对 象 
private DatagramPacket outPacket = null; 


public void init()throws IOException { 

try 

1 
// 创 建 一 个 客户 端 DatagramSocket， 使 用 随机 端口 
socket = new DatagramSocket(); 
/初始 化 发 送 用 的 DatagramSocket， 它 包含 一 个 长 度 为 0 的 字 节 数组 
outPacket = new DatagramPacket(new byte[0] , 0 , 

InetAddress.getByName(DEST IP), DEST PORT); 

/创建 键盘 得 入流 
Scanner scan = new Scanner(System.in); 
// 不 断 读 取 键盘 输入 
while(scan.hasNextLine()) 


{ 


// 将 键盘 输入 的 一 行 字符 串 转 换 字 节 数组 
byte[] buff = scan.nextLine().getBytes(); 
/设置 发 送 用 的 DatagramPacket 里 的 字 节 数据 
outPacket.setData(buff); 

/发 送 数据 报 
socket.send(outPacket); 

// 读 取 Socket 中 的 数据 ， 读 到 的 数据 放 在 inPacket 所 封装 的 字 节 数组 里 。 


socket.receive(inPacket); 


System.out.printIn(new String(inBuff , 0, 
inPacket.getLength())); 


j 

/使 用 finally 块 保证 关闭 资源 
finally 

1 


if (socket != null) 


1 


socket.close(); 


} 
public static void main(String[] args) 
throws IOException 


new UdpClient().init(); 


上 述 代码 通过 DatagramSocket 实现 了 发 送 并 接收 DatagramPacket 的 功能 ， 有 具体 实现 与 服 
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务 器 的 实现 代码 基本 相似 。 而 客户 端 与 服务 端的 唯一 区 别 是 服务 器 所 在 卫 地 址 和 端口 是 固定 
的 ， 所 以 客户 端 可 以 直接 将 该 数据 报 发 送 给 服务 器 ， 而 服务 器 需要 根据 接收 到 的 数据 报 决定 
“反馈 ”数据 报 的 目的 地 。 


5.3.2 ”使 用 MulticastSocket 


DatagramSocket 只 人 允许 将 数据 报 发 送 给 指定 的 目标 地 址 ， 而 MulticastSocket 可 以 将 数据 
报 以 广播 的 方式 发 送 到 数量 不 等 的 多 个 客户 端 。 如 果 要 使 用 多 点 广播 ， 需 要 让 一 个 数据 报 标 
有 一 组 目标 主机 地 址 ， 当 发 出 数据 报 后 ， 整 个 组 的 所 有 主机 都 能 收 到 该 数据 报 。 卫 多 点 广播 
《或 多 点 发 送 ) 实现 可 以 将 单一 信息 发 送 到 多 个 接收 者 ， 功 能 是 设置 一 组 特殊 网 络 地 址 作为 多 
点 广播 地 址 ， 每 一 个 多 点 广播 地 址 都 被 看 做 一 个 组 ， 当 客户 端 需要 发 送 、 接 收 广播 信息 时 ， 
只 需 加 入 到 该 组 即 可 。 
IP 为 多 点 广播 提供 了 这 批 特殊 的 IP 地 址 ， 这 些 IP 地 址 的 范围 是 224.0.0.0 至 
235.255.255.255. 
MulticastSocket 类 既 可 以 将 数据 报 发 送 到 多 点 广播 地 址 ， 也 可 以 接收 其 他 主机 的 广播 信 
A. MulticastSocket 类 是 DatagramSocket 类 的 一 个 子 类 ， 当 要 发 送 一 个 数据 报时 ， 可 使 用 随 
机 端口 创建 MulticastSocket， 也 可 以 在 指定 端口 来 创建 MulticastSocket。 
在 类 MulticastSocket 中 提供 了 如 下 三 个 构造 器 。 
口 public MulticastSocket(): 使 用 本 机 默认 地 址 、 随 机 端口 来 创建 一 个 MulticastSocket 
对 象 。 
口 public MulticastSocket(int portNumber): 使 用 本 机 默认 地 址 、 指 定 端口 来 创建 一 个 
MulticastSocket 对 象 。 
O public MulticastSocket(SocketAddress bindaddr): 使 用 本 机 指定 IP 地 址 、 指 定 端口 来 创 
建 一 个 MulticastSocket X% - 
在 创建 一 个 MulticastSocket 对 象 后 ， 需 要 将 该 MulticastSocket 加 入 到 指定 的 多 点 广播 地 
址 。 在 MulticastSocket 中 使 用 jionGroup0 方 法 加 入 到 一 个 指定 的 组 ,使 用 leaveGroup0) 方 法 从 
一 个 组 中 脱离 出 去 。 这 两 个 方法 的 具体 说 明 如 下 。 
O joinGroup(InetAddress multicastAddr): 将 该 MulticastSocket 加 入 到 指定 的 多 点 广播 地 址 。 
口 leaveGroup(InetAddress multicastAddr): 使 该 MulticastSocket S FH EREA H 
地 址 。 
在 某 些 系统 中 可 能 有 多 个 网 络 接口 ， 这 可 能 会 对 多 点 广播 带 来 问题 ， 此 时 程序 需要 在 一 
个 指定 的 网 络 接口 上 监听 ， 通 过 调用 setInterface 可 选择 MulticastSocket 所 使 用 的 网 络 接口 ， 
也 可 以 使 用 getInterface 方法 查询 MulticastSocket 监听 的 网 络 接口 。 
如 果 创 建 只 发 送 数据 报 的 MulticastSocket 对 象 ， 则 只 需 使 用 默认 地 址 和 随机 端口 即 可 。 
如 果 创 建 接收 用 的 MulticastSocket 对 象 ， 则 该 MulticastSocket 对 象 必须 具有 指定 端口 ， 否 则 
发 送 方 无 法 确定 发 送 数据 报 的 目标 端口 。 
HAYEK MulticastSocket 实现 发 送 /接收 数据 报 的 方法 与 DatagramSocket 的 完全 一 样 ， 但 是 
MulticastSocket 比 DatagramSocket 多 了 下 面 的 方法 。 


setTimeToLive(int ttl) 


参数 “tl” 设 置 数据 报 最 多 可 以 跨 过 多 少 个 网 络 ， 具 体 说 明 如 下 。 
138 mm 
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为 0 时 : 指定 数据 报应 停留 在 本 地 3 
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时 : 数据 报应 保留 在 本 大 洲 。 


a 


为 1 时 : 指定 数据 报 发 送 到 本 地 局 域 网 。 
为 32 时 : 只 能 发 送 到 本 站 点 的 网 络 
为 64 时 : 数据 报应 保留 在 本 地 区 。 


diss 


Ay 255 时 : 数据 报 可 发 送 到 所 有 地 方 。 
为 1 时: 是 默认 值 。 
使 用 MulticastSocket 实现 多 点 广播 时 ， 所 有 通信 实体 都 是 平等 的 ， 都 将 自己 的 数据 报 


发 送 到 多 点 广播 IP 地 址 ， 并 使 用 MulticastSocket 接收 其 他 人 发 送 的 广播 数据 报 。 例 如 在 下 面 


的 代码 中 ， 使 用 MulticastSocket 实现 了 一 个 基于 广播 的 多 人 聊天 室 ， 程 请 
两 个 线程 ， 其 中 MulticastSocket 既 用 于 发 送 ， 也 用 于 接收 ， 其 中 一 个 线程 分 
并 向 MulticastSocket 发 送 数据 ， 另 一 个 线程 则 负责 从 


MulticastSocket， 
别 负责 接受 用 户 键盘 输入 ， 


MulticastSocket 中 读 取 数据 。 
Jy: daima\5\tcpudp\src\manySocket.java 


import java.awt.*; 


import java.net.*; 


import java.io.*; 


import java.util. 


// 让 该 类 实现 Runnable 接口 ， 


Ke 
3 


public class manySocket implements Runnable 


1 


/使 用 常量 作为 本 程序 的 多 点 广播 卫 地 址 


private static final String IP 


public static 


="230.0.0.1"; 
/使 用 常量 作为 本 程序 的 多 点 广播 目的 的 端 


final int PORT = 30000; 


/定义 每 个 数据 报 的 最 大 大 小 为 4KB 
private static final int LEN = 2048; 
/定义 本 程序 的 MulticastSocket 实例 
private MulticastSocket socket = null; 
private InetAddress bAddress = null; 
private Scanner scan = null; 
/定义 接收 网 络 数据 的 字 节 数组 
byte[] inBuff = new byte[LEN]; 


DFR EP 


private DatagramPacket inPacket = 


new D 


发 送 的 DatagramPacket 对 象 


private DatagramPacket oPacket = null; 


public void init()throws IOException 


{ 
try 
{ 


该 类 的 实例 可 作为 线程 的 target 


节 数 组 创建 准备 接受 数据 的 DatagramPacket 对 象 


atagramPacket(inBuff , inBuff.length); 
MENAR 


只 需要 一 个 
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// 创 建 用 于 发 送 、 接 收 数据 的 MulticastSocket 对 象 

// 因 为 该 MulticastSocket 对 象 需要 接收 ， 所 以 有 指定 端口 
socket = new MulticastSocket(PORT); 

bAddress = InetAddress.getByName(IP); 

/将 该 socket 加 入 指定 的 多 点 广播 地 址 
socket.joinGroup(bA ddress); 

// 设 置 本 MulticastSocket 发 送 的 数据 报 被 回 送 到 自身 
socket.setLoopbackMode(false); 

// 初 始 化 发 送 用 的 DatagramSocket， 它 包含 一 个 长 度 为 0 的 字 节 数组 
oPacket = new DatagramPacket(new byte[0] , 0， 

bAddress , PORT); 

/局 动 以 本 实例 的 run0 方 法 作为 线程 体 的 线程 

new Thread(this).start(); 

/创建 键盘 得 入流 

scan = new Scanner(System.in); 

/不 断 读 取 键 盘 输 入 

while(scan.hasNextLine()) 


{ 


// 将 键盘 输入 的 一 行 字符 串 转 换 字 节 数 组 
byte[] buff = scan.nextLine().getBytes(); 
/设置 发 送 用 的 DatagramPacket 里 的 字 节 数据 
oPacket.setData(buff); 

/发 送 数据 报 
socket.send(oPacket); 


j 
finally 


1 


socket.close(); 


public void run() 
1 
try 
{ 
while(true) 


{ 


// 读 取 Socket 中 的 数据 ， 读 到 的 数据 放 在 inPacket 所 封装 的 字 节 数组 里 。 

socket.receive(inPacket); 

/打印 输出 从 socket 中 读 取 的 内 容 

System.out.printin(" 聊 天 信息 : "+ new String(inBuff, 0 , 
inPacket.getLength())); 


fa 


} 
/捕捉 异常 
catch (IOException ex) 
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ex.printStackTrace(); 
try 
1 
if (socket != null) 
{ 
/让 该 Socket 离开 该 多 点 IP 广播 地 址 
socket.leaveGroup(bA ddress); 
/关闭 该 Socket 对 象 
socket.close(); 
j 
System.exit(1); 
} 
catch (IOException e) 
{ 
e.printStackTrace(); 
} 


public static void main(String[] args) 


throws IOException 


new manySocket().init(); 


1 
} 
} 
{ 
} 


j 


上 述 代码 的 实现 流程 如 下 。 


O 在 init0 方 法 中 创建 一 个 MulticastSocket 对 象 ， 因 为 需要 使 用 该 对 象 接收 数据 报 ， 所 以 
为 此 Socket 对 象 设 置 使 用 固定 端口 。 
O 将 该 Socket 对 象 添加 到 指定 的 多 点 广播 卫 地 址 。 


yL E 


ü Wwe 


口 使 月 


该 Socket 发 送 的 数据 报 回 


5.4 在 Android 中 使 用 Socket 实现 数据 传输 


Android 平台 


通过 本 章 前 面 内 容 的 学 习 ， 已 经 了 解 了 在 Java 应 用 中 Socket 网 络 编程 的 基本 知识 。 在 
PP， 可 以 使 用 相同 的 方法 用 Socket 实现 数据 传输 功能 。 


送 到 自身 ， 即 该 Socket 可 以 接收 到 自己 发 送 的 数据 报 。 


H MulticastSocket 发 送 并 接收 数据 报 ， 与 使 用 DatagramSocket 并 没有 区 别 。 


在 本 市 的 内 容 中 ， 将 通 


过 一 个 具体 实例 的 实现 过 程 ， 来 讲解 在 Android 中 使 用 Socket 实现 数据 传输 的 基本 方法 。 


H 的 


源码 路 径 


实例 5-1 使 用 Socket 实现 数据 传输 


daima\5\socket 


本 实例 的 具体 实现 流程 如 下 。 
先 实现 服务 器 端 ， 使 用 Eclipse 新 建 一 个 名 为 “android server" DI Java 工程 ， 然 后 


(DH 
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编写 服务 器 端的 实现 文件 AndroidServerjava， 功 能 是 创建 Socket AIS client 以 接受 客户 端 请 


求 ， 并 创建 BufferedReader 对 象 in 向 服务 器 发 送 消息 。 文 件 AndroidServerjava 的 具体 实现 代 


人 码 如 下 。 


public class AndroidServer implements Runnable{ 


public void run() { 


try 1 


ServerSocket serverSocket-new ServerSocket(54321); 


while(true) 


1 


getInputStream())); 


System.out.printin(" 等 待 接收 用 户 连 接 :"); 
/接受 客户 端 请 求 

Socket client=serverSocket.accept(); 

try 

1 


// 接 受 客户 端 信息 
BufferedReader in=new BufferedReader(new InputStreamReader(client. 


String str=in.readLine(); 

System.out.println("read: "+str); 
// 回 服务 器 发 送 消息 
PrintWriter out=new PrintWriter(new BufferedWriter(new OutputStream Writer 


(client.getOutputStream())),true); 


j 


out.printin("return "+str); 
in.close(); 
out.close(); 

jcatch(Exception ex) 


{ 
System.out.println(ex.getMessage()); 
ex.printStackTrace(); 

} 

finally 

{ 
client.close(); 
System.out.printIn("close"); 

} 


} catch (IOException e) { 
System.out.println(e.getMessage()); 


j 


public static void main(String [] args) 


1 


Thread desktopServerThread-new Thread(new AndroidServer()); 
desktopServerThread.start(); 
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(2) 开始 实现 客户 端的 测试 程序 ， 使 用 Eclipse 新 建 一 个 名 为 “testSocket” 的 Android T 
程 ， 编 写 布局 文件 main.xml， 在 主 界面 中 插入 一 个 信息 输入 文本 框 和 一 个 “发 送 ” 按 钮 。 文 


TF main.xml 的 具体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation="Vvertical" android:layout_width="fill_parent" 
android:layout_height="fill_parent"> 
<EditText android:id="@+id/edit" android:layout width-"fill parent" 
android:layout height-"wrap content" /> 
«Button android:id="@+id/but1" android:layout width-"wrap content" 
android:layout height-"wrap content" android:text-" /z XX" /> 
<TextView android:id="@+id/text1" android:layout width-"fill parent" 
android:layout height-"wrap content" android:text="@string/hello" /> 
</LinearLayout> 


(3) 编写 测试 文件 TestSocketjava， 功 能 是 获取 输入 框 的 文本 信息 ， 并 将 信息 发 送 到 


“192.168.2.113”。 文件 TestSocket.java 的 具体 实现 代码 如 下 。 


/客户 端的 实现 
public class TestSocket extends Activity { 
private TextView text]; 
private Button but1; 
private EditText edit1; 
private final String DEBUG_TAG="mySocketAct"; 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContent View(R.layout.main); 
textl=(TextView)find ViewById(R.id.text1); 
but1=(Button)findViewByld(R.id.but 1); 
edit 1=(EditText)find ViewByld(R.id.edit); 
but1.setOnClickListener(new Button.OnClickListener() 
1 
@Override 
public void onClick(View v) { 
Socket socket=null; 
String mesg=edit1.getText().toString()+"\r\n"; 
edit1.setText(""); 
Log.e("dddd", "sent id"); 


try { 
socket=new Socket("192.168.2.113",54321); 


AI I B ri BIS i D 


PrintWriter out-new PrintWriter(new BufferedWriter(new OutputStream Writer 


(socket.getOutputStream())),true); 
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out.printIn(mesg); 


/接受 服务 器 的 信息 


BufferedReader br=new BufferedReader(new InputStreamReader(socket. 


getInputStream())); 
String mstr=br.readLine(); 
if(mstr!=null) 
{ 
text1.setText(mstr); 
}else 
{ 
text1.setText(" Bue Kë Gun, 
} 
out.close(); 
br.close(); 
socket.close(); 
} catch (UnknownHostException e) { 
e.printStackTrace(); 
} catch (IOException e) { 
e.printStackTrace(); 
jcatch(Exception e) 
{ 
Log.e(DEBUG TAG,e.toString()); 


(4) 在 文件 AndroidManifest.xml 中 添加 访问 网 络 的 权限 ， 且 体 代 码 如 下 。 
<!-- 添加 可 以 通 迅 协议 --> 


<uses-permission android:name="android.permission. INTERNET" /> 


到 此 为 止 ， 整 个 实例 介绍 完毕 ， 执 行 后 的 效果 如 图 5-2 所 示 。 


图 5-2 执行 效果 
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可 扩展 标记 语言 (Extensible Markup Language, XML) 与 HTML 一 样 ， 都 是 标准 通用 标 
记 语 言 (Standard Generalized Markup Language，SGML)。 通 过 使 用 XML 技术 可 以 实现 对 数 
据 的 存储 。 在 本 章 的 内 容 中 ， 将 详细 讲解 在 Android 系统 中 处 理 XML 数据 的 基本 知识 ， 为 读 


者 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 
6.1 XML 技术 基础 


XML 是 Internet 环 境 中 跨 平 台 的 , 依赖 于 内 容 的 技术 ,是 当前 处 理 结构 化 文档 信 ， 


BAJ 


TA. XML 是 一 种 简单 的 数据 存储 语言 ， 使 用 一 系列 简单 的 标记 描述 数据 ， 而 这 些 标记 可 以 
用 简便 的 方式 建立 ， 虽 然 XML 占用 的 空间 要 比 二 进 制 数据 多 ， 但 是 XML 极其 简单 易于 掌握 


和 使 用 。 在 本 节 的 内 容 中 ， 将 简要 介绍 XML 技术 的 基本 知识 。 
6.1.1 XML 概述 


XML 与 Access、Oracle 和 SQL Server 等 数据 库 不 同 , 数据 库 提供 了 更 强 有 力 的 数据 存储 和 
分 析 能 力 ， 例 如 数据 索引 、 排 序 、 查 找 、 相 关 一 致 性 等 ，XML 仅仅 是 展示 数据 。XML 与 其 


他 数据 表现 形式 最 大 的 不 同 是 它 极 其 简 8 


XML 的 简单 使 其 易于 在 任何 应 用 程序 中 读 写 数据 ， 这 使 XML 很 快 成 为 数据 交换 的 唯一 


公共 语言 , 虽然 不 同 的 应 用 软件 也 文 持 其 他 的 数据 交换 格式 , 但 不 久之 后 它们 都 将 支持 XML， 


然后 可 以 很 容易 加 载 XML 数据 到 程序 中 并 解析 ， 并 以 XML 格式 输出 结果 。 


那 就 意味 着 程序 可 以 更 容易 的 与 Windows、Mac OS, Linux 以 及 其 他 平台 下 产生 的 信息 结合 ， 


为 了 使 SGML 用 户 界 面 友好 ，XML 重新 定义 了 SGML 的 一 些 内 部 值 和 参数 ， 去 掉 了 大 


XML 同时 也 推出 一 种 新 型 文档 类 型 ， 使 开发 者 也 可 以 不 必定 义 文档 类 型 。 


成 为 少数 公司 的 僵 利 工具 ，XML 不 是 一 种 依附 于 特定 浏览 器 的 语言 。 
6.1.2 XML 的 语法 


量 很 少 用 到 的 功能 。XML 保留 了 SGML 的 结构 化 功能 ， 使 网 站 设计 者 可 以 自 定义 文档 类 型 ， 


因为 XML 是 W3C 制 定 的 , XML 的 标准 化 工作 由 W3C 的 XML 工作 组 负责 , 该 小 组 成 员 
由 来 自 各 个 地 方 和 行业 的 专家 组 成 。 因为 XML 是 一 个 公共 格式 ， 所 以 无 须 担心 XML 技术 会 


XML 用 来 存储 数据 ， 对 HTML 语言 进行 扩展 ， 它 和 HTML 分 工 很 明确 ，XML 是 用 来 存 
储 数据 , 而 HTML 是 用 来 如 何 表现 数据 的 , 下 面 通过 一 段 程序 代码 进行 讲解 , 其 代码 (6-2.xml) 


如 下 。 
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<?xml version="1.0" encoding="utf-8"?> 
<book> 

<person> 

<first>Kiran</first> 

<last>Pai</last> 

<age>22</age> 

</person> 


<person> 
<first>Bill</first> 
<last>Gates</last> 
<age>46</age> 
</person> 
<person> 
<first>Steve</first> 
<last>Jobs</last> 
<age>40</age> 
</person> 
</book> 


上 面 的 代码 只 要 符合 语法 还 可 以 写成 汉语 ， 如 下 面 (6-3.xml) 代码 。 


<?xml version="1.0" encoding="utf-8"?> 
«Jo A> 
< 名 > 天 上 星 </ 名 > 

< 电子 邮件 >tianshangxing@hotmail.com</ 电 子 邮 件 

< 住宅 > 何 国 何 市 何 区 何 街道 何 番号 </ 住 宅 > 

< 电话 >86-021-742745674</ 电 话 > 

< 一 言 >XML 学 习 </ 一 言 > 
</ 项 目 > 


V 


从 上 面 两 段 代 码 可 以 看 出 ，XML 的 标记 方式 完全 可 以 自由 定义 ， 不 受 约束 ， 它 只 是 用 来 
存储 信息 。 除 了 第 一 行 固定 以 外 ， 其 他 的 只 需 前 后 标签 一 致 ， 末 标签 不 能 省 略 ， XML 语法 
格式 总 结 如 下 。 
在 第 一 行 必须 对 XML 进行 声明 ， 也 即 声明 XML 的 版 本 。 
它 的 标记 和 HTML 一 样 是 成 对 出 现 。 

XML 对 标记 的 大 小 写 敏 感 。 
XML 标记 是 用 户 自 定义 的 ， 但 是 每 一 个 标记 必须 有 结束 标记 。 


6.1.3 ”获取 XML 文档 
获取 XML 文档 十 分 简单 ， 下 面 通 过 一 个 简单 的 Java 代码 来 获取 6.12 节 中 6-2.xml 文件 
的 信息 ， 其 代码 如 下 。 


import java.io.File; 


LI 


At 


Ooo 


import org.w3c.dom.Document; 
import org.w3c.dom.*; 
import javax.xml.parsers.DocumentBuilderFactory; 
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import javax.xml.parsers.DocumentBuilder; 
import org.xml.sax.SA X Exception; 
import org.xml.sax.SA XParseException; 
public class ReadAndPrintXMLFile{ 
public static void main (String argv [])1 
try { 
DocumentBuilderFactory docBuilderFactory 
= DocumentBuilderFactory.newInstance(); 
DocumentBuilder docBuilder 
— docBuilderFactory.newDocumentBuilder(); 
Document doc = docBuilder.parse (new File("6-2.xml")); 
doc.getDocumentElement ().normalize (); 
System.out.println ("Root element of the doc is " 
+ doc.getDocumentElement().getNodeName()); 
NodeList listOfPersons = doc.getElementsBy TagName("person"); 
int totalPersons — listOfPersons.getLength(); 
System.out.printIn(" Total no of people : " + totalPersons); 
for(int s=0; s<listOfPersons.getLength() ; s++){ 
Node firstPersonNode = listOfPersons.item(s); 
if(firstPersonNode.getNodeType() == Node.ELEMENT NODE){ 
Element firstPersonElement = (Element)firstPersonNode; 
NodeList firstNameList = 
firstPersonElement.getElementsBy TagName("first"); 
Element firstNameElement 
— (Element)firstNameList.item(0); 
NodeList textFNList = firstNameElement.getChildNodes(); 
System.out.printIn("First Name : "十 
((Node)textFNList.item(0)).getNodeValue().trim()); 
NodeList lastNameList 
= firstPersonElement.getElementsByTagName( last"); 
Element lastNameElement = (Element)lastNameList.item(0); 
NodeList textLNList = lastNameElement.getChildNodes(); 
System.out.printIn("Last Name : " + 
((Node)textLNList.item(0)).getNodeValue().trim()); 
NodeList ageList 
= firstPersonElement.getElementsBy TagName("age"); 
Element ageElement — (Element)ageList.item(0); 
NodeList textAgeList = ageElement.getChildNodes(); 
System.out.printIn("Age : "+ 
((Node)textAgeList.item(0)).getNode Value().trim()); 


ae e 
catch (SAXParseException err) 


System.out.println ("** Parsing error" +", line " 
+ err.getLineNumber () +", uri" + err.getSystemld ()); 
System.out.println(" " + err.getMessage ());  ) 
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catch (SAXException e) { 


} 


Exception x = e.getException (); 
((x = null) ? e : x).printStackTrace (); 


catch (Throwable t) { 


用 户 在 Java API 还 可 以 找到 更 多 操作 XML 文档 的 方法 ， 执 行 上 述 代码 后 得 到 如 


所 示 的 结 


t.printStackTrace (); 


P. BI @ Jevadoc E 控制 台 Z x | SIE 


《已 终止 > ReadAndPrintXMLFile [Java 应 用 程序 ] C:\Program Files\Java\jre6\bin\j avaw. exe ( 2009-2-19 


Root element of the doc is book 
Total no of people : 3 
First Name : Kiran 
Last Name : Pai 

Age : 22 

First Name : Bill 
Last Name : Gates 

Age : 46 

First Name : Steve 
Last Name : Jobs 

Age : 40 


图 6-1 获取 XML 文档 


m 


6-1 


pm E-ri- 


注意 : 读者 需要 注意 的 是 ，XML 主要 用 来 存储 信息 ， 不 负责 显示 在 页 面 。 获 取 XML X. 


档 的 方法 有 很 多 ， 


等 ， 也 和 包括 HTML 语言 。 


6.2 ”使 用 


SAX， 全 称 Simple API for XML, 


SAX 解析 XML 数据 


Megginson XH 
其 原始 API 的 


SAX 没有 必须 遵守 的 标准 SAX 参考 版 本 。 因 此 ，SAX 的 不 同 


也 并 不 是 只 有 Java 语言 ， 还 有 许多 语言 都 可 以 调用 ， 如 C#、PHP 和 ASP 


既是 一 种 接口 ， 也 是 一 个 软件 包 。SAX 最 初 是 由 David 
H Java 语言 开发 , 之 后 SAX 很 快 在 Java 开发 者 中 流行 起 来 。San 现在 负责 管理 
发 工作 ， 这 是 一 种 公开 的 、 开 源 软件 。 不 同 于 其 他 大 多 数 XML 标准 的 是 ， 


在 本 节 的 内 容 ， 


， 将 简要 介绍 SAX 技术 的 基本 知识 。 


6.24 SAX 的 原理 


SAX 的 工 


始 与 结束 、 文 档 结束 等 地 方 时 通知 事件 处 理 函 数 ， 由 事件 处 到 


实现 可 能 采用 区 别 很 大 的 接口 。 


作 原 理 简 单 地 说 就 是 对 文档 进行 顺序 扫描 ， 当 扫描 到 文档 开始 与 结束 、 元 素 开 


同样 的 扫描 ， 直 全 文档 结束 。 


大 多 数 SAX 实现 都 会 产生 以 下 五 种 类 型 的 事件 。 


口 在 文档 的 开始 和 绪 束 时 触发 文档 处 理事 件 。 
口 在 文档 内 每 一 个 XML 元 素 接受 解析 的 前 后 触发 元 素 事 


口 任何 元 数据 通常 都 由 单独 的 事件 交付 。 
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O 在 处 理 文 档 的 DTD 或 Schema 时 产生 DTD 或 Schema 事件 。 
口 产生 错误 事件 以 通知 主机 应 用 程序 解析 错误 。 


6.2.2 ”基于 对 象 和 基于 事件 的 接口 
语法 分 析 器 有 两 类 接口 : 基于 对 象 接口 和 基于 事件 的 接口 。 DOM 是 基于 对 象 的 语法 分 析 
器 的 标准 的 API。 作 为 基于 对 象 的 接口 ，DOM 通过 在 内 存 中 显示 地 构建 对 象 树 来 与 应 用 程 请 
通信 。 对 象 树 是 XML 文件 中 元 素 树 的 精确 映射 。 
DOM 易于 学 习 和 使 用 ， 因 为 它 与 常用 的 XML 文档 关系 密切 ， 两 者 的 语法 十 分 相似 。 在 
现实 应 用 中 ，DOM 的 最 常见 应 用 便 是 操作 XML 文件 中 的 数据 ， 例 如 ， 浏 览 器 程序 和 编译 器 
程序 。 
然而 ， 对 于 大 多 数 应 用 程序 ， 处 理 XML 文档 只 是 其 众多 任务 中 的 一 种 。 例 如 ， 记 账 软 
件 包 可 能 导入 XML 格式 的 发 票数 据 ,， 但 这 不 是 其 主要 用 途 。 计 算账 户 余额 、 跟 踊 文 出 以 及 使 
寸 敌 与 发 票 匹 配 才 是 主要 活动 。DOM 模型 不 太 适 合 记 帐 应 用 程序 ， 因 为 在 那 种 情况 下 ， 应 
程序 必须 在 内 存 中 维护 数据 的 两 个 副本 (一 个 是 DOM 树 , 男 一 个 是 应 用 程序 自己 的 结构 )。 
在 内 存 维护 两 次 数据 会 使 应 用 程序 运行 效率 下 降 。 对 于 桌面 应 用 程序 来 说 ， 这 可 能 不 是 主要 
问题 ， 但 是 它 可 能 会 导致 服务 器 瘫痪 。 对 于 不 以 XML 为 中 心 的 应 用 程序 ，SAX 是 明智 的 选 
择 。 实 际 上 ，SAX 并 不 在 内 存 中 显 式 地 构建 文档 树 。 它 使 应 用 程序 能 用 最 有 效率 的 方法 存储 
数据 。 
应 用 程序 如 何在 XML 树 及 其 自身 数据 结构 之 间 进 行 映射 ， 如 图 6-2 所 示 。 


price 
quote 


vendor 


图 6-2 ”将 XML 结构 映射 成 应 用 程序 结构 


SAX 是 基于 事件 的 接口 ， 基 于 事件 的 语法 分 析 器 将 事件 发 送 给 应 用 程序 。 这 些 事件 类 似 
于 用 户 界面 事件 ， 例 如 ， 浏 览 器 中 的 ONCLICK 事件 或 者 Java 中 的 AWT/Swing 事件 。 

事件 通知 应 用 程序 发 生 了 某 件 事 并 需要 应 用 程序 作出 反应 ， 在 浏览 器 中 ， 通 常 为 响应 用 
户 操作 而 生成 事件 ， 当 用 户 单 击 按钮 时 ， 按 钮 产生 一 个 ONCLICK 事件 。 

在 XML 语法 分 析 器 中 , 事件 与 用 户 操作 无 关 , 而 与 正在 读 取 的 XML 文档 中 的 元 素 有 关 。 
在 XML 语法 分 析 器 中 可 以 处 理 以 下 方面 的 事件 。 

口 元 素 开始 和 结束 标记 。 

口 元 素 内 容 。 
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口 实体 。 
口 语法 分 析 错 误 。 


语法 分 析 器 在 读 取 文 档 时 生成 事件 的 过 程 ， 如 图 6-3 Bran. 


<xbe:price-list><xbe:product>XML Training«/xbe:product»«xbe:price-quote/». . . 


图 6-3 语法 分 析 器 生成 事件 


这 两 种 API 中 没有 一 种 在 本 质 上 是 最 好 的 ， 它 们 适用 于 不 同 的 需求 。 在 需要 更 多 控制 时 
使 用 SAX; 要 增加 方便 性 时 ， 则 使 用 DOM， 例 如 ，DOM 在 脚本 语言 中 很 流行 。 

采用 SAX 的 主要 原因 是 效率 。 SAX 比 DOM 做 的 事 要 少 , 但 提供 了 对 语法 分 析 器 的 更 多 
控制 。 当 然 ， 如 果 语 法 分 析 器 的 工作 减少 ， 则 意味 着 开发 者 有 更 多 的 工作 要 做 。 而 且 ， 正 如 
我 们 已 讨论 的 ，SAX H DOM 消耗 的 资源 要 少 ， 因 为 它 不 需要 构建 文档 树 。 在 XML 早期 ， 
DOM 得 益 于 W3C 批准 的 官方 API 这 一 身份 。 逐渐 地 , 开发 者 选择 了 功能 性 而 放弃 了 方便 性 ， 
并 转向 了 SAX。 

SAX 的 主要 限制 是 它 无 法 向 后 浏览 文档 。 实 际 上 ， 激 发 一 个 事件 后 ， 语 法 分 析 器 就 将 其 
“ 态 记 ” 如 我 们 所 看 到 的 ， 应 用 程序 必须 显 式 地 缓冲 其 感 兴趣 的 事件 。 


6.2.3 ”常用 的 接口 和 类 
在 现实 开发 应 用 中 ，SAX 将 其 事件 分 为 如 下 的 接口 。 
口 ContentHandler: 定义 与 文档 本 身 关 联 的 事件 (例如 ， 开 始 和 结束 标记 )。 大 多 数 应 用 
程序 都 注册 这 些 事件 。 
QO DTDHandler: 定义 与 DTD 关联 的 事件 。 然而 ， 它 不 定义 足够 的 事件 来 完整 地 报告 
DTD。 如 果 需 要 对 DTD 进行 语法 分 析 ， 请 使 用 可 选 的 DeclHandler。DeclHandler 是 
SAX 的 扩展 ， 并 且 不 是 所 有 的 语法 分 析 器 都 支持 它 。 
口 EntityResolver: 定义 与 装 入 与 实体 关联 的 事件 。 只 有 少数 几 个 应 用 程序 注册 这 些 事件 。 
口 ErrorHandler: 定义 错误 事件 。 许 多 应 用 程序 注册 这 些 事件 以 便 用 它们 自己 的 方式 报错 。 
为 简化 工作 ，SAX 在 DefaultHandler 类 中 提供 了 这 些 接口 的 默认 实现 。 在 大 多 数 情况 下 ， 
为 应 用 程序 扩展 DefaultHandler 并 获 盖 相关 的 方法 要 比 直接 实现 一 个 接口 更 容易 。 
1. XMLReader 
如 果 为 事件 注册 处 理 器 并 启动 语法 分 析 器 ， 应 用 程序 应 该 使 用 XMLReader 接口 ， 实 现 方 
法 是 使 用 XMLReader 的 parse() 方 法 来 启动 ， 具 体 语法 格式 如 下 。 


parser.parse(args[0]); 


XMLReader 中 的 主要 方法 如 下 。 

(1) parse(): 对 XML 文档 进行 语法 分 析 。parse0 有 两 个 版 本 ， 一 个 接受 文件 名 或 URL, 
另 一 个 接受 InputSource 对 象 。 
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(2) setContentHandler(), setDTDHandler(). setEntityResolver()#ll setErrorHandler(): 为 应 
用 程序 注册 事件 处 理 器 。 

(3) setFeature0 和 setProperty0: 控制 语法 分 析 器 如 何 工 作 。 它 们 采用 一 个 特性 或 功能 标 
识 〈 一 个 类 似 于 名 称 空间 的 URI 和 值 )。 功 能 采用 Boolean 值 ， 而 特性 则 采用 “对 象 ” 

最 常用 的 XMLReaderFactory 功能 如 下 。 

(1) http:// xml.org/sax/features/namespaces: 所 有 SAX 语法 分 析 器 都 能 识别 它 。 如 果 将 它 
设置 为 true〈 默 认 值 )， 则 在 调用 ContentHandler 的 方法 时 ， 语 法 分 析 器 将 识别 出 名 称 空 间 并 
解析 前 绥 。 

(2) http://xml.org/sax/features/validation: 它 是 可 选 的 。 如 果 将 它 设 置 为 tue， 则 验证 语法 
分 析 器 将 验证 该 文档 。 非 验证 语法 分 析 器 忽略 该 功能 。 

2. XMLReaderFactory 

XMLReaderFactory 用 于 创建 语法 分 析 器 对 象 ， 它 定义 了 createXMLReader() 的 如 下 
两 个 版 本 。 

E 一 个 采用 语法 分 析 器 的 类 名 作为 参数 。 

口 一 个 从 org.xml.sax.driver 系统 特性 中 获得 类 名 称 。 

对 于 Xerces， 类 是 org.apache.xerces.parsers.SAXParser。 应 该 使 用 XMLReaderFactory， 
因为 它 易 于 切换 至 另 一 种 SAX 语法 分 析 器 。 实 际 上 ， 只 需要 更 改 下 面 一 行 然后 重新 编译 
即 可 。 


XMLReaderparser=XMLReaderFactory.createX MLReader( 
"org.apache.xerces.parsers.SA X Parser"); 


为 获得 更 大 的 灵活 性 ， 应 用 程序 可 以 从 命令 行 读 取 类 名 或 使 用 不 带 参 数 的 
createXMLReader() 方 法 。 因 此 可 以 不 重新 编译 就 可 以 更 改 语法 分 析 器 。 

3. InputSource 

InputSource 控制 语法 分 析 器 如 何 读 取 文 件 ， 包 括 XML 文档 和 实体 。 在 大 多 数 情 况 下 ， 
文档 是 从 URL 装 入 的 。 但 是 ， 有 特殊 需求 的 应 用 程序 可 以 覆盖 InputSource. 例如， 可 以 用 来 
从 数据 库 中 装 入 文档 。 

4. ContentHandler 

ContentHandler 是 最 常用 的 SAX 接口 ， 因 为 它 定义 XML 文档 的 事件 。ContentHandler 声 
明 以 下 几 个 事件 。 

(1) startDocument()/endDocument(): 通知 应 用 程序 文档 的 开始 或 结束 。 

(2) startElement()/endElement(): 通知 应 用 程序 标记 的 开始 或 结束 。 属 性 作为 Attributes 
参数 传递 。 即使 只 有 一 个 标记 ,“ 空 ”元 素 (例如 ，<imghre 伍 "logo.gif"'/>) 也 生成 startElement() 
和 endElement()。 

(3) startPrefixMapping()/endPrefixMapping(): 通知 应 用 程序 名 称 空间 作用 域 。 儿 乎 不 需 
要 该 信息 ， 因 为 当 http://xml.org/sax/features/namespaces 为 true 时 ， 语 法 分 析 器 已 经 解析 了 名 
称 空间 。 

(4) 当 语 法 分 析 器 在 元 素 中 发 现 文本 时 ，charactersOyVignorableWhitespace0O 会 通知 应 用 程序 。 
语法 分 析 器 负责 将 文本 分 配 到 几 个 事件 (为 了 更 好 地 管理 其 缓冲 区 )。ignorableWhitespace 事 
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件 用 于 接收 元 素 内 容 中 可 忽略 空白 的 通知 。 
(5) processingInstruction(): 将 处 理 指令 通知 应 用 程序 。 
(6) skippedEntity(): 通知 应 用 程序 已 经 跳 过 了 一 个 实体 。 
(7) setDocumentLocator(): 将 Locator 对 象 传递 到 应 用 程序 。 不 需要 SAX 语法 分 析 器 提 

fit Locator， 但 是 如 果 它 提供 了 ， 则 必须 在 任何 其 他 事件 之 前 激活 该 事件 。 
5. 属性 
在 startElement0 事 件 中 ， 应 用 程序 在 Attributes 参数 中 接收 属性 列表 。 


Stringattribute=attributes.getValue("","price"); 


Attributes 定义 了 下 列 方 法 。 
口 getValue(iy/getValue(qName)/getValue(urijlocalName): 返回 第 i 
属性 值 。 
O getLength(): 返回 属性 数目 。 
O getQName(i)/getLocalName(i)/getURI(i): 返回 限定 名 《〈 带 前 绥 )、 本 地 名 《〈 不 带 前 绥 ) 
和 第 i 个 属性 的 名 称 空间 URI。 
口 getType(i)/getType(qName)/getType(urilocalName): 返回 第 i 个 属性 的 类 型 或 者 给 定名 
称 的 属性 类 型 。 类 型 为 字符 串 ， 即 在 DTD 中 所 使 用 的 :“CDATA”、“ID”、“IDREF”、 
* [DREFS ” “NMTOKEN ” *NMTOKENS ” “ENTITY ” “ENTITIES ”或 
“NOTATION”. 
注意 : Attributes 参数 仅 在 startElement(O) 事 件 期 间 可 用 。 如 果 在 事件 之 间 需 要 它 ， 则 需 用 
AttributesImpl 复制 一 个 。 
6. 定位 器 
Locator 为 应 用 程序 提供 行 和 列 的 位 置 。 不 需要 语法 分 析 器 来 提供 Locator 对 象 。Locator 
定义 下 列 方 法 。 
口 getColumnNumber(): 返回 当前 事件 结束 时 所 在 的 列 。 在 endElement0 事 件 中 ， 它 将 返 
回 结束 标记 所 在 的 最 后 一 列 。 
口 getLineNumber0: 返回 当前 事件 结束 时 所 在 的 行 。 在 endElementO 事 件 中 ， 它 将 返回 
结束 标记 所 在 的 行 。 
口 getPublicId0: 返回 当前 文档 事件 的 公共 标识 。 
口 getSystemId0: 返回 当前 文档 事件 的 系统 标识 。 
7. DTDHandler 
DTDHandler 声明 两 个 与 DTD 语法 分 析 器 相关 的 事件 。 有 具体 如 下 。 
口 notationDecl0: 通知 应 用 程序 已 经 声明 了 一 个 标记 。 
口 nparsedEntityDecl(): 通知 应 用 程序 已 经 发 现 了 一 个 未 经 过 语法 分 析 的 实体 声明 。 
8. EntityResolver 
EntityResolver 接口 仅 定 义 一 个 事件 resolveEntity0， 它 返回 InputSource. DD SAX 语法 
分 析 器 已 经 可 以 解析 大 多 数 URL， 所 以 应 用 程序 很 少 实现 EntityResolver。 例外 情况 是 对 于 目 
录 文 件 它 将 公共 标识 解析 成 系统 标识 。 如果 在 应 用 程序 中 需要 目录 文件 , 请 下 载 Norman Walsh 
的 目录 软件 包 。 
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9. ErrorHandler 

ErrorHandler 接口 定义 错误 事件 。 处 理 这 些 事件 的 应 用 程序 可 以 提供 定制 错误 处 理 。 安 装 
了 定制 错误 处 理 器 后 ， 语 法 分 析 器 不 再 抛 出 异常 。 抛 出 异常 是 事件 处 理 器 的 责任 。 接 口 定义 
了 与 错误 的 三 个 级 别 或 严重 性 对 应 的 三 个 方法 。 

O waming0: 警示 不 是 由 XML 规范 定义 的 错误 。 例 如 ， 当 没有 XML 声明 时 ， 某 些 语 

法 分 析 器 发 出 警告 ， 它 不 是 错误 ， 但 是 它 可 能 值得 注意 。 

口 error): 警示 由 XML 规范 定义 的 错误 。 

口 fatalError): 警示 由 XML 规范 定义 的 致命 错误 。 

10. SAXException 

SAX EMI KS ROTA A APH SAXException. 4%} XML 文档 进行 语法 分 析 时 ， 
SAXException 会 抛 出 一 个 错误 ， 这 里 的 错误 可 以 是 语法 分 析 错 误 也 可 以 是 事件 处 理 器 中 的 错 
误 。 要 报告 来 自 事件 处 理 器 的 其 他 异常 ， 可 以 将 异常 封装 在 SAXException 中 。 


6.2.4 ”实战 演练 一 一 在 Android 系统 中 使 用 SAX 解析 XML 数据 


Android 中 可 以 使 用 标准 的 XML 生成 器 、 解 析 器 、 转 换 器 API, OS XML 进行 解析 和 
转换 。 本 实例 的 功能 是 ， 在 Android 系统 中 使 用 SAX 技术 解析 并 生成 XML。 


题 - H 的 源码 路 径 
实例 6-1 在 Android 系统 中 解析 和 生成 XML daima\6\XML Parser 


本 实例 的 具体 实现 流程 如 下 。 
CD 编写 布局 文件 main.xml， 有 具体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


android:orientation="Vvertical" > 
<TextView 


android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/hello" /> 


</LinearLayout> 


CD 编写 解析 功能 的 核心 文件 SAXForHandlerjava， 主 要 实现 代码 如 下 。 


public class SAXForHandler extends DefaultHandler { 
private static final String TAG = "SAXForHandler"; 
private List<Person> persons; 
private String perTag ;// 通 过 此 变量 ， 记 录 前 一 个 标签 的 名 称 。 
Person person;// 记 录 当 前 Person 
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public List<Person> getPersons() { 
return persons; 

j 

/适合 在 此 事件 中 触发 初始 化 行为 。 

public void startDocument() throws SAXException { 
persons = new ArrayList<Person>(); 
Log.i(TAG , "***startDocument()***"); 


j 
public void startElement(String uri, String localName, String q Name, 
Attributes attributes) throws SAXException ( 
if("person" equals(localName)) { 
for ( int i = 0; i < attributes.getLength(); i++ ) { 
Log.1(TAG ,"attributeName:" + attributes. getLocalName(1) 
+" attribute Value:" + attributes.getValue(1)); 
person = new Person(); 
person.setId(Integer.valueOf(attributes.getValue(1))); 


j 


perTag = localName; 
Log.i(TAG , qName-"***startElement()***"): 


= 一 


public void characters(char[] ch, int start, int length) throws SAXException { 
String data = new String(ch, start, length).trim(); 
if(!"" equals(data.trim())) { 
Log.i(TAG ,"content: " + data.trim()); 
} 
if("name".equals(perTag))1 
person.setName(data); 
yelse if("age" equals(perTag)) { 
person.setAge(new Short(data)); 


} 


public void endElement(String uri, String localName, String qName) 
throws SAXException { 
Log.i(TAG , qName-"***endElement()* **"); 
if("person" equals(localName)) { 
persons.add(person); 
person = null; 
j 
perTag = null; 
j 
public void endDocument() throws SAXException { 
Log.i(TAG , "***endDocument()***"); 


= 一 


u Spe 处理 XML 数据 
(3) 编写 单元 测试 文件 PersonServiceTestjava， 上 有 具体 代码 如 下 。 


public void testSAXGetPersons() throws Throwable { 
InputStream inputStream = this.getClass().getClassLoader(). 
getResourceAsStream("wang.xml"); 
SAXForHandler saxForHandler = new SAXForHandler(); 
SAXParserFactory spf = SAXParserFactory.newInstance(); 
SAXParser saxParser — spf.newSA XParser(); 
saxParser.parse(inputStream, saxForHandler); 
List<Person> persons = saxForHandler.getPersons(); 
inputStream.close(); 
for(Person person:persons) { 
Log.i(TAG, person.toString()); 


DS 


此 时 使 用 Eclipse 启动 Android 模拟 器 ， 执 行 后 的 效果 如 
(Se | 


6-4 所 示 。 


D XML Parser 


图 6-4 执行 效果 

(4) 开始 具体 测试 ， 在 Eclipse 中 导入 本 实例 项 目 ， 在 “Outline” 面 板 中 右键 单 击 
testSAXGetPersons(), 如 图 6-5 所 示 。 在 弹出 命令 中 依次 选择 Run As 一 Android JUnit Test 命令 ， 
如 图 6-6 所 示 。 


Open Type Hierarchy F4 
Mei 1 Üpen Call Hierarchy CtrltAlttH 
CissstomderQ). Show In AltiShi ft Hf 
*tPersons(inStream); of Cut Ctrl+X 
[E Copy Ctrl+C 
[Copy Qualified Name 
[5j Paste CtrltV 
ible{ X Delete Delete 
:ClassLoader().getResource s Mu £t4S 
= = 1etPersans(inStream) : oe pees 
B= Outline 52 E lí wow ew = 日 » Refactor AlttShi ft+T 
Zb com. xml " References 
H-O  PersonServiceTest S Declarations 
PF - 
e T T O ai =F with nid anm Tae ee ; © Toggle Method Breakpoint 
sons lj 
e EUN om Me o : É 1 Android JUnit Test 
es volc 
P ate See 0 : i Ju2 JUnit Test AlttShiftHX, T Debug Às 
@ test! getPersons voic Profile As 
© testSave () void Run Configurations... Compare With 
-4th p SE ` : : ES 
图 6-5 右键 单 击 tessDOMgetPersons() 图 6-6 选择 Android JUnit Test 子 菜单 
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此 时 将 在 LogCat 中 显示 测试 的 解析 结果 ， 如 图 6-7 所 示 。 


Je. Declaration EJ Console SD LogCat 33 — m 


Search for messages. Accepts Java regexes. Prefix with pid:, app:, tag: or text: to limit scope [verbose 了 | H Sim 4 
Lives | Time | PID | TID | Application | Tag | Text aj 


10-20 10:54:12.385 1349 1362 com. mmm. xml SAXForHandler age***endElement () *** 
10-20 10:54:12.395 1349 1362 com. mmm. xml SAXForHandler person***endElement (zz: 
10-20 10:54:12.395 1349 1362 com.mmm.xml SAXForHandler persons***endElement (Oz 
10-20 10:54:12.405 1349 1362 com.mmm.xml SAXForHandler ***endDocument () *** 
:12.405 1349 1362 com.mmm.xml PersonServi...  id-23,name-NEwii,age-21 
10-20 10:54:12.405 1349 1362 com.mmm.xml PersonServi...  id-20,name-WiiWill,age-: 
10-20 10:54:12.405 1349 1362 com.mmm.xml TestRunner finished: testSAXGetPer: 
10-20 10:54:12.405 1349 1362 com.mmm.xml TestRunner passed: testSAXGetPersoi 
10-20 10:54:12.456 1339 1339 AndroidRuntime  Shutting down VM S 


Bb bb HH HH 
ka 
o 
1 
N 
o 
H 
o 
"m 
E) 


图 6-7 解析 结果 


注意 : 如 果 Android 下 的 Eclipse 界面 中 没有 LogCat 面板 ， 只 需 依次 单 击 Eclipse X X42 
中 的 Window ^ show view > other > Android 命令 ， 然 后 选择 LogCat 后 即 可 在 Eclipse 界面 看 到 
LogCat 面板 。 


6.3 ”使 用 DOM 解析 XML 


文件 对 象 模型 (Document Object Model, DOM), te W3C 组 织 推荐 的 处 理 可 扩展 置 标语 
言 的 标准 编程 接口 。 在 本 节 的 内 容 中 ， 将 详细 讲解 在 Android 系统 中 使 用 DOM 解析 XML 的 
基本 知识 。 


6.3.1 DOM 概述 


DOM 可 以 以 一 种 独立 于 平台 和 语言 的 方式 访问 和 修改 一 个 文档 的 内 容 和 结构 。 换 句 话 
说 ， 这 是 表示 和 处 理 一 个 HTML 或 XML 文档 的 常用 方法 。 有 一 点 很 重要 ，DOM 的 设计 是 以 
对 和 象 管理 组 织 (OMG) 的 规约 为 基础 的 ， 因 此 可 以 用 于 任何 编程 语言 。 最 初 人 们 把 它 认 为 是 
一 种 让 JavaScript 在 浏览 器 间 可 移植 的 方法 , 不 过 DOM 的 应 用 已 经 远 远 超出 这 个 范围 。 DOM 
技术 使 得 用 户 页 面 可 以 动态 地 变化 ， 如 可 以 动态 地 显示 或 隐藏 一 个 元 素 ， 改 变 它们 的 属性 ， 
增加 一 个 元 素 等 ，DOM 技术 使 得 页 面 的 交互 性 大 大 地 增强 。 

DOM 实际 上 是 以 面向 对 象 方式 描述 的 文档 模型 。DOM 定义 了 表示 和 修改 文档 所 需 的 对 
象 、 这 些 对 象 的 行为 和 属性 以 及 这 些 对 象 之 间 的 关系 。 可 以 把 DOM 认为 是 页 面 上 数据 和 结 
构 的 一 个 树 形 表 示 ， 不 过 页 面 当然 可 能 并 不 是 以 这 种 树 的 方式 具体 实现 。 
通过 JavaScript 可 以 重 构 整 个 HTML 文档， 可 以 添加 、 移 除 、 改 变 或 重 排 页 面 上 的 项 
要 想 改 变 页 面 ，JavaScript 需要 获得 对 HTML 文档 中 所 有 元 素 进行 访问 的 入 口 。 这 个 
连同 对 HTML 元 素 进行 添加 、 移 动 、 改 变 或 移 除 的 方法 和 属性 ， 都 是 通过 DOM 来 
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6.3.2 DOM 的 结构 


根据 W3C DOM 规范 ，DOM 是 HTML 与 XML 的 API, DOM 将 整个 页 面 映射 为 一 个 由 
E dà 点 组 成 的 文件 。 有 一 级 、 二 级 、 三 级 共 三 个 级 别 ， 各 个 级 别 的 具体 说 明 如 下 。 
— DOM 

us DOM FE 1998 年 10 月 份 成 为 W3C 的 提议 内 容 ， 由 DOM 核心 与 DOM HTML 两 个 
模块 组 成 。DOM 核心 能 映射 以 XML 为 基础 的 文档 结构 ， 允 许 获取 和 操作 文档 的 任意 部 分 。 
DOM HTML 通过 添加 HTML 专用 的 对 象 与 函数 对 DOM 核心 进行 了 扩展 。 

. 二 级 DOM 

pes 级 DOM 仅 以 映射 文档 结构 为 目标 ， 二 级 DOM 则 更 为 宽广 。 通 过 对 原 有 DOM 的 
扩展 , 二 级 DOM 通过 对 象 接口 增加 了 对 鼠标 和 用 户 界 面 事件 (DHTML 长 期 文 持 鼠 标 与 用 户 
界面 事件 )、 范 围 、 遍 历 〈 重 复 执行 DOM 文档 ) FRSC (CSS) 的 支持 。 同 时 也 对 一 
级 DOM 的 核心 进行 了 扩展 ， 从 而 可 支持 XML 命名 空间 。 

在 二 级 DOM 中 ， 引 进 了 如 下 所 示 的 新 DOM 模块 来 处 理 新 的 接口 类 型 。 

QO DOM 视图 : 描述 跟踪 一 个 文档 的 各 种 视图 (使 用 CSS 样式 设计 文档 前 后 ) 的 接 

口 DOM 事件 : 描述 事件 接 
口 DOM 样式 : 描述 处 理 基于 CSS 样式 的 接 
口 
3 


DOM 遍历 与 范围 : 描述 遍历 和 操作 文档 树 的 接 
. 三 级 DOM 
三 级 DOM 通过 引入 统一 方式 载 入 和 保存 文档 和 文档 验证 方法 对 DOM 进行 进一步 扩展 ， 
三 级 DOM 包含 一 个 名 为 “DOM 载 入 与 保 在 ”的 新 模块 ，DOM 核心 扩展 后 可 支持 XML1.0 
的 所 有 内 容 ， 包 扩 XML Infoset、XPath、 和 XML Base。 
4. “0 级 ”DOM 
当 阅 读 与 DOM 有 关 的 材料 时 ， 可 能 会 遇 到 “参考 0 级 DOM” 的 情况 。 在 此 需要 注意 的 
是 ， 并 没有 标准 被 称 为 0 级 DOM， 它 仅 是 DOM 历史 上 的 一 个 参考 点 。0 级 DOM 被 认为 是 
在 Internet Explorer 4.0 与 Netscape Navigator4.0 上 被 支持 的 最 早 的 DHTML 。 
5. 节点 
Ri DOM, HTML 文档 中 的 每 个 成 分 都 是 一 个 节点 。 关 于 使 用 节点 的 具体 规则 , DOM 
是 这 样 规定 的 。 
口 整个 文档 是 一 个 文档 节点 。 
O 每 个 HTML 标签 是 一 个 元 素 节点 。 
口 包含 在 HTML 元 素 中 的 文本 是 文本 节点 。 
口 每 一 个 HIML 属性 是 一 个 属性 节点 。 
口 注释 属于 注释 节点 。 
6. Node 的 层次 
在 DOM 中 ， 各 个 节点 之 间 彼 此 都 有 着 等 级 关系 。HTML 文档 中 的 所 有 节点 组 成 了 一 个 
文档 树 Git ABD. HTML 文档 中 的 每 个 元 素 、 属 性 、 文 本 等 都 代表 着 树 中 的 一 个 节点 。 
树 起 始 于 文档 节点 ， 此 继续 延伸 ， 直 到 处 于 这 棵 树 最 低级 别 的 所 有 文本 节点 为 止 。 例 如 
图 6-8 演示 了 一 个 文档 树 《〈《 节 点 树 ) 的 结构 。 


EB 157 


Android 网 络 开发 从 入 门 到 精通 


图 6-8 ”一 个 文档 树 《〈 节 点 树 ) 的 结构 


7. SM CARD 
请 读者 看 如 下 的 HTML xfi. 
<html> 
<head> 
«title-DOM Tutorial</title> 
</head> 
<body> 
<h1>DOM Lesson one</h1> 
<p>Hello world!</p> 
</body> 
</html> 


在 上 述 代码 中 ， 所 有 的 节点 彼此 间 都 存在 关系 ， 具 体 说 明 如 下 。 

口 除 文档 节点 之 外 的 每 个 节点 都 有 父 节 点 。 例 如 <head> 和 <body> 的 父 节 点 是 «html 

节点 ， 文 本 节点 “Hello world!” 的 父 节 点 是 <p> 节点 。 

OQ 大 部 分 元 素 节点 都 有 子 节点 。 例 如 <head> 节点 有 一 个 子 节 点 : <title>. <title> 节点 

也 有 一 个 子 节点 : 文本 节点 “DOM Tutorial”. 

口 当 节 点 有 同一 个 父 节点 时 ， 它 们 就 是 同辈 〈 同 级 节点 )。 例 如 <hl> 和 <p> 是 同 右 ， 因 

为 它们 的 父 节点 均 是 <body> 节点 。 

口 节点 也 可 以 拥有 后 代 ， 后 代 指 某 个 节点 的 所 有 子 节 点 ， 或 者 这 些 子 节点 的 子 节点 ， 以 

此 类 推 。 例 如 所 有 的 文本 节点 都 是 <html> 节 点 的 后 代 ， 而 第 一 个 文本 节点 是 <head> 

节点 的 后 代 。 

口 节点 也 可 以 拥有 先辈 。 先 辈 是 某 个 节点 的 父 节 点 ， 或 者 父 节 点 的 父 节 点 ， 以 此 类 推 。 
例如 所 有 的 文本 节点 都 可 把 <html> 节点 作为 先辈 节点 。 


6.3.3 ”实战 演练 一 一 在 Android 系统 中 使 用 DOM 解析 XML 数据 
本 实例 的 功能 是 ， 在 Android 系统 中 使 用 DOM 技术 来 解析 并 生成 XML。 


Bi H H 的 源码 路 径 


题 H 
实例 6-2 在 Android 系统 中 解析 和 生成 XML daima\6\XML_Parser 
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本 实例 的 具体 实现 流程 如 下 。 
(1) 编写 布局 文件 main.xml， 具 体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
android:orientation="Vvertical" > 
<TextView 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/hello" /> 
</LinearLayout> 
(2) 编写 解析 功能 的 核心 文件 DOMPersonService.java， 具 体 实现 流程 如 下 。 
O 创建 DocumentBuilderFactory XJ $& factory， 并 调用 newInstance0 创 建新 实例 。 
O 创建 DocumentBuilder 对 象 builder, DocumentBuilder 将 实现 具体 的 解析 工作 以 创 开 
Document 对 象 。 
口 解析 目标 XML 文件 以 创建 Document AIS 
文件 DOMPersonService java 的 具体 实现 代码 如 下 。 


public class DOMPersonService { 


m 


public static List<Person> getPersons(InputStream inStream) throws Exception { 
List<Person> persons = new ArrayList<Person>(); 
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); 
DocumentBuilder builder = factory newDocumentBuilder(); 
Document document = builder.parse(inStream); 
Element root = document.getDocumentElement(); 
NodeList personNodes = root.getElementsByTagName("person"); 
for(int i=0; i < personNodes.getLength() ; i++) { 
Element personElement = (Element)personNodes.item(i); 
int id = new Integer(personElement.getAttribute("id")); 
Person person = new Person(); 
person.setId(id); 
NodeList childNodes — personElement.getChildNodes(); 
for(int y=0; y < childNodes.getLength() ` y++){ 
if(childNodes.item(y).getNodeType()==Node.ELEMENT_NODE){ 
if("name".equals(childNodes.item(y).getNodeName())) { 
String name = childNodes.item(y).getFirstChild().getNodeValue(); 
person.setName(name); 
yelse if("age".equals(childNodes.item(y).getNodeName()))1 
String age = childNodes.item(y).getFirstChild().getNode Value(); 
person.setA ge(new Short(age)); 
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} 
persons.add(person); 


} 
inStream.close(); 


return persons; 


(3) 编写 单元 测试 文件 PersonServiceTestjava， 上 有 具体 代码 如 下 。 


public void testDOMgetPersons() throws Throwable{ 
InputStream inStream = this.getClass().getClassLoader(). 
getResourceAsStream("wang.xml"); 


List<Person> persons = DOMPersonService.getPersons(inStream); 
for(Person person : persons) { 
Log.i(TAG, person.toString()); 


(4) 开始 具体 测试 ， 在 Eclipse 中 导入 本 实例 项 目 ， 在 Outline 面板 中 右键 单 击 
testDOMgetPersons() : void, 如 图 6-9 所 示 。 在 弹出 命令 中 依次 选择 Run As 一 Android JUnit Test 
命令 ， 如 图 6-10 所 示 。 

此 时 将 在 Logcat 中 显示 测试 的 解析 结果 ， 如 图 6-11 Bras. 

注意 : SAX 和 DOM 的 对 比 

DOM 解析 器 ， 是 通过 将 XML 文档 解析 成 树 形 模 型 并 将 其 放 入 内 存 来 完成 解析 工作 的 ， 
然后 对 文档 的 操作 都 是 在 这 个 树 形 模型 上 完成 的 。 这 个 在 内 存 中 的 文档 树 将 是 文档 实际 大 小 
的 几 倍 。 这 样 做 的 好 处 是 结构 清晰 、 操 作 方便 ， 而 带 来 的 麻烦 就 是 极其 耗费 系统 资源 。 

SAX 解析 器 ， 正 好 克服 了 DOM 的 缺点 ， 分 析 能 够 立即 开始 ， 而 不 是 等 待 所 有 的 数据 被 
处 理 。 而 且 ， 由 于 应 用 程序 只 是 在 读 取 数据 时 检查 数据 ， 因 此 不 需要 将 数据 存储 在 内 存 中 ， 
这 对 于 大 型 文档 来 说 是 个 巨大 的 优点 。 事 实 上 ， 应 用 程序 其 至 不 必 解 析 整 个 文档 ， 它 可 以 在 
某 个 条 件 得 到 满足 时 停止 解析 。 


Open Type Hierarchy 了 4 
Met Open Call Hierarchy CtrltalttH 
ClassLoader (). Show In Aus Ett 
*tPersons(inStream); of Cat Ctrl+X 
[B Copy Ctrl+C 
ES Copy Qualified Name 
(5 Paste Ctrlty 
ible( X Delete Delete 
x — ae Source €— 
BE Outline 23 Al™Z RW N H | » Refactor ALt+Shi £t+T 
HB com. xml m References 
H-O PersonServiceTest S Declarations 


oF TAG : String 


©  testSAXGetPersons() : void Pesfiv with mido ann das av gave 1, 9 Toggle Method Breakpoint 


f21 Android JUnit Test 


EW: (DON e (Pers ons Ó) : void ` SC 
@ testPullgetPersons() : void Ju 2 Tait Text cb CHA 
© testSave() ` void Run Configurations... Conpare With 
图 6-9 右键 单 击 tessDOMgetPersons() 图 6-10 选择 Android JUnit Test 子 菜单 


第 6 章 ”处理 XML 数据 


v. 
Search for messages. Accepts Java regexes. Prefix with pid:, app. tag. or text: to limit scope. |verbose x] H alos 

I1. | Time | PID | TID | Application | Tag | Text aj 

D E 20 LE ae: Ge = 1206 1286 dalvikvm Not ets Check: 


10-20 10 ` - PersonServi.. 


I 

I 10-20 10:50: as. 895 1286 1299 com.mmm.xml PersoRSerél... “as, name=WiiWill, age- 
I 10-20 10:50:45.905 1286 1299 com.mmm.xml TestRunner finished: testDOMgetPer: 
I 10-20 10:50:45.905 1286 1299 com.mmm.xml TestRunner passed: testDOMgetPerso! 
D 10-20 10:50:45.955 1276 1276 AndroidRuntime  Shutting down VM 

D 10-20 10:50:45.965 1276 1282 jdwp Got wake-up signal, bai 
D 10-20 10:50:45.965 1276 1282 dalvikvm Debugger has detached; ve 
«| | E 


图 6-11 解析 结果 
表 6-1 列 出 了 SAX fe DOM 在 一 些 方面 的 对 比 。 


表 6-1 SAX fü DOM 的 对 比 


SAX DOM 


顺序 读 入 文档 并 产生 相应 事件 ， 可 以 处 理 任何 大 小 的 XML 文档 在 内 存 中 创建 文档 树 ， 不 适 于 处 理 大 型 XML 文档 

只 能 对 文档 按 顺 序 解析 一 遍 ， 不 支持 对 文档 的 随意 访问 可 以 随意 访问 文档 树 的 任何 部 分 ， 没 有 次 数 限 制 
只 能 读 取 XML 文档 内 容 ， 而 不 能 修改 可 以 随意 修改 文档 树 ， 从 而 修改 XML 文档 

开发 上 比较 复杂 ， 需 要 自己 来 实现 事件 处 理 器 易于 理解 ， 易 于 开发 

对 开发 人 员 而 言 更 灵活 ， 可 以 用 SAX 创建 自己 的 XML 对 象 模型 已 经 在 DOM 基础 之 上 创建 好 了 文档 树 


6.4 PULL 解析 技术 


在 Android 网 络 开发 应 用 中 ， 除 了 可 以 使 用 SAX 和 DOM 技术 解析 XML 文件 外 ， 还 可 
以 使 用 Android 系统 内 置 的 PULL 解析 器 解析 XML 文件 。 在 本 节 的 内 容 中 ,将 详细 讲解 使 用 
PULL 技术 解析 XML 文件 的 具体 过 程 。 


6.41 PULL 解析 原理 


PULL 解析 器 的 运行 方式 与 SAX 解析 器 相似 ， 也 提供 了 类 似 的 功能 事件 ， 例 如 开始 元 
素 和 结束 元 素 事件 ， 使 用 parsernextO 可 以 进入 下 一 个 元 素 并 触发 相应 事件 。 事 件 将 作为 数值 
代码 被 发 送 ， 因 此 可 以 使 用 一 个 Switch 控件 对 感 兴 趣 的 事件 进行 处 理 。 当 元 素 开 始 解析 时 ， 
调用 parser.nextText0 方 法 可 以 获取 下 一 个 Text 类 型 元 素 的 值 。 

PULL 解析 器 的 源码 及 文档 下 载 网 址 : http:/www.xmlpull.org/ 

在 解析 过 程 中 ，PULL 是 采用 事件 驱动 方式 进行 解析 的 ， 当 PULL 解析 器 开始 解析 之 后 ， 
可 以 调用 它 的 next0) 方 法 来 获取 下 一 个 解析 事件 (就 是 开始 文档 ， 结 束 文档 ， 开 始 标 签 ， 结 束 
标签 )， 当 解析 到 某 个 元 素 时 可 以 调用 XmlPullParser 的 getAttributte() 方 法 来 获取 属性 的 值 ， 
也 可 调用 它 的 nextText0 方 法 获取 本 节点 的 值 。 


6.4.2 ”实战 演练 一 一 在 Midroid 系统 中 使 用 PULL 解析 XML 数据 
本 实例 的 功能 是 ， 在 Android 系统 中 使 用 PULL 技术 来 解析 并 生成 XML。 


Un 
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题 E 的 源码 路 径 
在 Android 系统 中 使 用 PULL 
解析 XML 文件 


实例 6-3 daima\6\XML_Parser 


本 实例 的 具体 实现 流程 如 下 。 
CD 编写 布局 文件 main.xml， 有 具体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
android:orientation="Vvertical" > 
<TextView 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/hello" /> 


</LinearLayout> 


(2) 编写 解析 功能 的 核心 文件 PullPersonService.java， 有 具体 实现 流程 如 下 。 

O 创建 DocumentBuilderFactory 对 象 factory， 并 调用 newInstance0O 创 建新 实例 。 

口 创建 DocumentBuilder AIS builder, DocumentBuilder 将 实现 具体 的 解析 工作 以 创 则 
Document 对 象 。 

O 解析 目标 XML 文件 以 创建 Document 对 象 。 

文件 PullPersonService.java 的 具体 实现 代码 如 下 。 


m 


public class PullPersonService { 
public static void save(List<Person> persons, OutputStream outStream) throws Exception { 

XmlSerializer serializer = Xml.newSerializer(); 

serializer.setOutput(outStream, "UTF-8"); 

serializer.startDocument("UTF-8", true); 

serializer.startTag(null, "persons"); 

for(Person person ` persons) { 
serializer.startTag(null, "person"); 
serializer.attribute(null, "id", person.getId().toString()); 
serializer.startTag(null, "name"); 
serializer.text(person.getName()); 
serializer.endTag(null, "name"); 
serializer.startTag(null, "age"); 
serializer.text(person.getA ge().toString()); 
serializer.endTag(null, "age"); 


serializer.endTag(null, "person"); 


} 
serializer.endTag(null, "persons"); 


serializer.endDocument(); 
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outStream.flush(); 
outStream.close(); 
j 
public static List<Person> getPersons(InputStream inStream) throws Exception { 
Person person = null; 
List<Person> persons = null; 
XmlPullParser pullParser = Xml.newPullParser(); 
pullParser.setInput(inStream, "UTF-8"); 
int event = pullParser.getEventType();// 触 发 第 一 个 事件 
while(event!=XmlPullParser.END DOCUMENT){ 
switch (event) { 
case XmlPullParser.START DOCUMENT: 
persons = new ArrayList<Person>(); 
break; 
case XmlPullParser.START TAG: 
if("person" equals(pullParser.getName())) { 
int id = new Integer(pullParser.getAttributeValue(0)); 


person = new Person(); 
person.setId(id); 
j 
if(person!=null) { 
if("name".equals(pullParser.getName())) { 
person.setName(pullParser.nextText()); 
j 
if("age".equals(pullParser.getName())) { 
person.setAge(new Short(pullParser.nextText())); 


} 
break; 
case XmlPullParser.END TAG: 
if("person" equals(pullParser.getName())) { 
persons.add(person); 
person = null; 
} 
break; 
} 


event = pullParser.next(); 


j 


return persons; 


(3) 编写 单元 测试 文件 PersonServiceTestjava， 上 有 具体 代码 如 下 。 


public void testPullgetPersons() throws Throwable{ 
InputStream inStream = this.getClass().getClassLoader().getResourceAsStream("wang.xml"); 
List<Person> persons = PullPersonService.getPersons(inStream); 
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for(Person person : persons){ 
Log.i(TAG, person.toString()); 


(4) 开始 具体 测试 ， 在 Eclipse 中 


导入 本 实例 项 目 ， 在 Outline 面板 中 右键 单 击 


testPullgetPersons(), 如 图 6-12 所 示 。 在 弹出 命令 中 依次 选择 Run As 一 Android JUnit Test 选项 ， 


如 图 6-13 所 示 。 


Be Outline 53 DNI 
ER com. xml 
EQ PersonServiceTest 
ow BF TAG 
e 


ELRO N 


String 


testSAXGetPersons () 
testDOMgetPersons () 
testPullgetPersons() 


void 


void 


e 
e void 
© testSave() ` void 


图 6-12 “右键 单 击 testDOMgetPersons() 


此 时 将 在 Logcat 中 显示 测试 的 解析 


gE 


ZH 


Open Type Hierarchy HI 


elei Open Call Hierarchy CtrltAlttH 
ER Show In ALttShigtt 
:tPersons(inStream) ; of Cut Col 

Copy Ctrl+C 

EO Copy Qualified Name 

(5 Paste Ctrl+V 
ible( X Delete Delete 
:ClassLoader().getResource p 
ietPersqns(inStream): = ERO LESTE 

] > Refactor AlttShift+T 
References 

2 Declarations 


honid 7, 9 Toggle Method Breakpoint 


m 
oid JUnit Test 


Ju2 JUnit Test AlttShifttX, T Debug As 
Profile As 
Run Configurations... Compare With 


图 6-13 Xf% Android JUnit Test 选项 


果 ， 如 图 6-14 所 示 。 


[verbose 了 | H alo 4 


Prefix with pid:, app:, tag: or text: to limit scope 

ae | Time | PID | TID | Application | Tag | Text aj 
D 10-20 21:38:47.713 976 976 dalvikvm Not late-enabling Check: 

I 10-20 21:38:48.002 976 989 com.mmm.xml TestRunner Started: testPullgetPer: 

I 10-20 21:38:48.252 976 989 com.mmm.xml PersonServi...  id-23,name-NEwii,age-21 

I 10-20 21:38:48.252 976 989 com.mmm.xml PersonServi... id=20,name=WiiWill, age=: 

I 10-20 21:38:48.252 976 989 com.mmm.xml TestRunner finished: testPullgetPe: 

I 10-20 21:38:48.264 976 989 com.mmm.xml TestRunner passed: testPullgetPers: 

D 10-20 21:38:48.323 966 966 AndroidRuntime  Shutting down VM 

D 10-20 21:38:48.333 966 972 jdwp Got wake-up signal, bai: 
a 1n-20n 21-38-48 333 ae a72 | dalywilwm Dehnamer haa detached- = 

图 6-14 解析 结果 


6.5 ”实战 演练 一 一 三 种 解析 方式 的 综合 演练 


在 本 节 的 内 容 中 ,将 通过 
技术 解析 XML 数据 的 具体 过 程 。 


个 


\ 


LSE BI AY SELLE, rie ee TE] SAX. DOM F PULL 


题 的 源码 路 径 
综合 演示 使 、 
实例 6-4 dis rss STEEN SE daima\6\XML_Parser 


本 实例 的 具体 实现 流程 如 下 。 
(1) 编写 主 界面 的 布局 文件 main.xml， 
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在 主 界面 


中 插入 三 个 Button 按钮 。 有 具体 实现 代码 
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如 下 。 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 


android:layout height-"fill parent" 


android:orientation-"vertical" > 


«Button 
android:id="@+id/btnSA X" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-" SAX 方式 解析 " /> 
«Button 
android:id="(@-+id/btnPULL" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="Pull 方式 解析 " /> 
<Button 
android:id="(@+id/btnDOM" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="Dom 方式 解析 " /> 
</LinearLayout> 


执行 后 的 主 界面 效果 如 图 6-15 所 示 。 


e XMLParser 


SAX 方 式 解析 
PULL 方 式 解 析 


DOM 方 式 解析 


图 6-15 执行 效果 


(2) 编写 列表 界面 文件 lstxml， 功 能 是 列表 显示 解析 后 的 结果 。 具 体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
android:orientation="Vvertical" > 
<TextView 
android:id="(@+id/textName" 
android:layout_width="fill_parent" 
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android:layout height-"wrap content" /> 
«TextView 

android:id="@+id/textId" 

android:layout_width="fill_parent" 

android:layout height-"wrap content" 

android: visibility="gone" 

/> 


</LinearLayout> 


(3) 编写 XML 文件 channels.xml， 本 实例 的 目的 就 是 使 用 SAX、DOM 和 PULL 技术 解 
析 此 XML 文件 中 的 数据 。 文 件 channels.xml 的 具体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 

<channel> 

<item id="0" url="http://www.baidu.com"> 百 度 </item> 
<item id="1" url="http://www.qq.com"> 腾 讯 </item> 
<item id="2" url="http:/www.sina.com.cn"> 新 浪 </item> 
«item id="3" url="http:/www.taobao.com"> 淘 宝 </item> 


</channel> 


€ 


(4) 编写 对 应 的 XML 实体 对 象 文件 cnanneljava， 有 具体 实现 代码 如 下 。 


public class channel { 
private String id; 
private String url; 
private String name; 
public String getId() { 


return id; 

j 

public void setId(String id) { 
this.id — id; 

j 

public String getUrl() { 
return url; 

j 

public void setUrl(String url) { 
this.url — url; 

j 


public String getName() 1 
return name; 
j 
public void setName(String name) 1 


this.name = name; 


(5) 编写 文件 XMLParserActivityjava， 用 于 响应 单 击 主 界面 三 个 按钮 的 事件 处 理 程序 。 
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其 体 实现 代码 如 下 。 


public class XMLParserActivity extends Activity { 
private Button btnSax; 
private Button btnPull; 
private Button btnDom; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
btnSax = (Button) find ViewByld(R.id.btnSAX); 
btnPull = (Button) find ViewByld(R.id.btnPULL); 
btnDom = (Button) find ViewByld(R.id.btnaDOM); 
btnSax.setOnClickListener(new OnClickListener() { 
@Override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
Intent intent = new Intent(); 
intent.setClass(XMLParserActivity.this, SAXPraserDemo.class); 


startActivity(intent); 
} 
Ir 
btnPull.setOnClickListener(new OnClickListener() { 
@Override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
Intent intent = new Intent(); 
intent.setClass(XMLParserActivity.this, PullPraserDemo.class); 
startActivity(intent); 
j 
Ir 
btnDom.setOnClickListener(new OnClickListener() { 
@Override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
Intent intent = new Intent(); 
intent.setClass(XMLParserActivity.this, DomPraserDemo.class); 
startActivity(intent); 
j 
D 


(6) 单 击 “SAX 方式 解析 ”按钮 后 ， 触 发 SAXPraserDemo 列表 以 显示 结果 ， 此 功能 的 实 
现 文件 是 SAXPraserDemo.java， 有 具体 实现 代码 如 下 。 
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public class SAXPraserDemo extends ListActivity { 
@Override 
protected void onCreate(Bundle savedInstanceState) { 


j 


// TODO Auto-generated method stub 
super.onCreate(savedInstanceState); 
SimpleAdapter adapter = null; 
try { 
adapter-new SimpleAdapter(this, getData(), R-layoutlistnew String[]{"name","id"} new int[]{ 
R.id.textName,R.id.textId 
Ir 
} catch (ParserConfigurationException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
} catch (SAXException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


j 
setListAdapter(adapter); 


private List<Map<String, String getData() throws ParserConfigurationException, SA XException, IOException 


1 


List<channel> list; 

list=getChannelList(); 

List<Map<String, String>> mapList=new ArrayList<Map<String,String>>(); 
for(int 1=0;i<list.size();1++) 


1 
Map<String, String> map-new HashMap<String, String>(); 
map.put("name", list.get(i).getName()); 
map.put("id", list.get(1).getId()); 
mapList.add(map); 
} 


return mapList; 


private List<channel> getChannelList() throws ParserConfigurationException, SAXException, IOException 


1 
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/实例 化 一 个 SAXParserFactory 对 象 

SAXParserFactory factory-S AXParserFactory.newInstance(); 
SA XParser parser; 

/实例 化 SAXParser 对 象 ， 创 建 XMLReader 对 象 ， 解 析 器 
parser=factory.newSAXParser(); 

XMLReader xmlReader-parser.getX MLReader(); 
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/实例 化 handler， 事 件 处 理 器 

SAXPraserHelper helperHandler=new SAXPraserHelper(); 
/解析 器 注册 事件 

xmlReader.setContentHandler(helperHandler); 

// 读 取 文 件 流 

InputStream stream=getResources().openRawResource(R.raw.channels); 


InputSource is=new InputSource(stream); 
/解析 文件 


xmlReader.parse(is); 


return helperHandler.getList(); 


a» 


在 上 述 代 码 中 ， 调 用 文件 SAXPraserHelperjava， 此 实现 了 有 具体 的 解析 工作 ， 文 件 具体 
现代 码 如 下 。 


public class SAXPraserHelper extends DefaultHandler { 
final int ITEM = 0x0005; 
List<channel> list; 
channel chann; 
int currentState = 0; 
public List<channel> getList() { 
return list; 
} 
/* 
* 接口 学 符 块 通知 
"uj 
@Override 
public void characters(char[] ch, int start, int length) 
throws SAXException { 
// TODO Auto-generated method stub 
// super.characters(ch, start, length); 


String theString = String.valueOf(ch, start, length); 
if (currentState !— 0) { 
chann.setName(theString); 
currentState = 0; 
} 
return; 
j 
/* 
* 接收 文档 结束 通知 
p 
@Override 
public void endDocument() throws SAXException { 
// TODO Auto-generated method stub 
super.endDocument(); 
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/* 
* 接收 标签 结束 通知 
*/ 
@Override 
public void endElement(String uri, String localName, String qName) 
throws SAXException { 
// TODO Auto-generated method stub 
if (localName.equals("item")) 
list.add(chann); 
j 
/* 
* 文档 开始 通知 
20 
@Override 
public void startDocument() throws SAXException { 
// TODO Auto-generated method stub 
list = new ArrayList<channel>(); 


} 
/* 
* 标签 开始 通知 
of 
@Override 
public void startElement(String uri, String localName, String qName, 
Attributes attributes) throws SAXException { 
// TODO Auto-generated method stub 
chann = new channel(); 


if (localName.equals("item")) { 
for (int 1 = 0; i < attributes.getLength(); i++) { 
if (attributes.getLocalName(1).equals("id")) { 
chann.setld(attributes.get Value(i)); 
} else if (attributes.getLocalName(i).equals("url")) { 
chann.setUrl(attributes.getValue(1)); 


} 
} 
currentState = ITEM; 
return; 
} 
currentState = 0; 
return; 
} 
} 
从 本 步骤 的 实现 过 程 可 以 看 出 ， 使 用 SAX 解析 XML 的 基本 步骤 如 下 。 
口 实例 化 一 个 工厂 SAXParserFactory。 
O 实例 化 SAXPraser 对 象 ， 创 建 XMLReader 解析 器 。 
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CQ 实例 化 handler 处 理 器 。 
口 解析 器 注册 一 个 事件 。 
口 读 取 文件 流 。 

口 解析 文件 。 


CD 单 击 “PULL 方式 解析 ”按钮 后 触发 PullPraserDemo 列表 显示 结果 ， 此 功能 的 实现 


文件 是 PullPraserDemo.java， 有 具体 实现 代码 如 下 。 


public class PullPraserDemo extends ListActivity { 

@Override 

protected void onCreate(Bundle savedInstanceState) { 
// TODO Auto-generated method stub 
super.onCreate(savedInstanceState); 
SimpleAdapter adapter = new SimpleAdapter(this, getData(), 

R.layout.list, new String[] { "id", "name" }, new int[] { 
R.id.textId, R.id.textName }); 

setListAdapter(adapter); 

} 

private List<Map<String, String>> getData() { 
List<Map<String, String>> list = new ArrayList<Map<String, String>>(); 
XmlResourceParser xrp = getResources().getXml(R.xml.channels); 


try 1 


/ 直到 文档 的 结尾 处 
while (xrp.getEventType() != XmlResourceParser.END DOCUMENT) { 
/| 如 果 遇 到 了 开始 标签 
if (xrp.getEventType() — XmlResourceParser.START TAG) { 
String tagName = xrp.getName();// 获取 标签 的 名 字 
if (tagName.equals("item")) { 
Map<String, String> map = new HashMap<String, String>(); 
String id = xrp.getAttributeValue(null, "id");// 通过 属性 名 来 获取 
/ 属性 值 


map.put("id", id); 
String url = xrp.getAttributeValue(1);// 通过 属性 索引 来 获取 属性 值 
map.put("url", url); 

map.put("name", xrp.nextText()); 

list.add(map); 


} 
xrp.next();// 获取 解析 下 一 个 事件 


p 


} 
} catch (XmlPullParserException e) { 


// TODO Auto-generated catch block 
e.printStackTrace(); 

} catch (IOException e) 1 
// TODO Auto-generated catch block 
e.printStackTrace(); 
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return list; 


(8) 单 击 “DOM 方式 解析 ”按钮 后 ， 触 发 DomPraserDemo 列表 以 显示 结果 ， 此 功能 的 
实现 文件 是 DomPraserDemo.java， 上 基体 实现 代码 如 下 。 
public class DomPraserDemo extends ListActivity { 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
// TODO Auto-generated method stub 
super.onCreate(savedInstanceState); 


SimpleAdapter adapter = new SimpleAdapter(this, getData(), 
R.layout.list, new String[] { "id", "name" }, new int[] { 
R.id.textId, R.id.textName }); 
setListAdapter(adapter); 
j 
private List<Map<String, String>> getData() { 
List<Map<String, String>> list = new ArrayList<Map<String, String>>(); 
InputStream stream = getResources().openRawResource(R.raw.channels); 
List<channel> channlist = DomParserHelper.getChannelList(stream); 
for (int 1 = 0; 1 < channlist.size(); i++) { 
Map<String, String> map = new HashMap<String, String>(); 
channel chann = (channel) channlist.get(i); 
map.put("id", chann.getId()); 
map.put("url", chann.getUrl()); 
map.put("name", chann.getName()); 
list.add(map); 
j 


return list; 


在 上 述 代码 中 ， 调 用 文件 DomParserHelperjava， 此 实现 了 有 具体 的 解析 工作 。 文 件 具 体 实 
现代 码 如 下 。 


public class DomParserHelper { 
public static List<channel> getChannelList(InputStream stream) 
1 
List<channel> list=new ArrayList<channel>(); 
/得 到 DocumentBuilderFactory WA, 由 该 对 象 可 以 得 到 DocumentBuilder 对 象 
DocumentBuilderFactory factory-DocumentBuilderFactory.newlInstance(); 
try { 
// 得 到 DocumentBuilder 对 象 
DocumentBuilder builder-factory.newDocumentBuilder(); 
/得 到 代表 整个 XML 的 Document 对 象 
Document document=builder.parse(stream); 
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/得 到 “ 根 节点 ” 

Element root=document.getDocumentElement(); 
/获取 根 节 点 的 所 有 items 的 节点 

NodeList items=root.getElementsByTagName("item"); 
/遍历 所 有 节点 

for(int i=0;i<items.getLength();i++) 


{ 


channel chann=new channel(); 
Element item=(Element)items.item(1); 
chann.setId(item.getAttribute("id")); 
chann.setUrl(item.getA ttribute("url")); 
chann.setName(item.getFirstChild().getNodeValue()); 
list.add(chann); 
} 
} catch (ParserConfigurationException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
} catch (SAXException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
} 


return list; 


从 本 步骤 的 实现 过 程 可 以 看 出 ， 使 用 DOM 解析 XML 的 基本 步骤 如 下 。 

口 调用 DocumentBuilderFactorynewInstance() 方 法 得 到 DOM 解析 器 工厂 类 实例 。 

口 调用 解析 器 工厂 实例 类 的 newDocumentBuilder0 方 法 得 到 DOM 解析 器 对 象 。 

口 调用 DOM 解析 器 对 象 的 parse0 方法 解析 XML 文档 得 到 代表 整个 文档 的 
Document 对 象 。 

到 此 为 止 ， 整 个 实例 的 实现 过 程 讲解 完毕 。 因 为 是 解析 的 同一 个 目标 文件 ， 所 以 单 击 任 

意 一 个 按钮 后 都 会 显示 一 样 的 效果 ， 有 具体 效果 如 图 6-16 所 示 。 


D XMLParser 


图 6-16 解析 后 的 效果 
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在 Android 系统 中 ，WebKit 是 一 个 系统 内 置 的 浏览 器 框架 。WebKit 是 一 个 经 典 的 、 开 源 
的 浏览 器 网 页 排版 引擎 , 内 含 WebCore 排版 引擎 和 JSCore 引擎 , 而 这 两 个 引擎 是 来 自 于 KDE 
项 目的 KHTML 和 KIS 开源 项 目 。 在 Android 平台 的 Web 引擎 框架 中 ， 采 用 了 WebKit 项 
中 的 WebCore 和 JSCore 部 分 ， 上 层 由 Java 语言 封装 ， 并 且 作 为 API 提供 给 Android 应 用 开 
发 者 , 而 底层 使 用 WebKit 核心 库 (WebCore 和 JSCore) 进 行 网 页 排版 ,本 章 将 详细 讲解 WebKit 
浏览 器 的 基本 知识 ， 并 讲解 开发 Android 网 页 应 用 程序 的 基本 方法 。 


7| WebKit 类 库 介 绍 


在 Android 源码 系统 中 ，WebKit 系统 分 成 Java 和 WebKit 库 两 个 部 分 。 
口 Java 层 : 负责 与 Android 应 用 程序 进行 通信 。 
口 WebKit 类 库 : 因为 是 由 C/C++ 实现 的 ， 所 以 也 被 称 为 C JERE, WebKit 类 库 部 分 负责 
实际 的 网 页 排版 处 理 。 
在 开发 Android 网 络 应 用 程序 时 ， 和 开发 过 程 密切 相关 的 是 WebKit 类 库 模 块 。 在 本 节 的 
内 容 中 ， 将 详细 讲解 Android 系统 中 WebKit 类 库 的 基本 知识 。 


111 主要 类 


在 Android 系统 中 ，WebKit 模块 的 Java 层 一 共 由 41 个 文件 组 成 ， 其 中 主要 的 类 的 具体 
说 明 如 下 。 

C1) WebView 

类 WebView 是 WebKit 模块 Java 层 的 视图 类 , 所 有 需要 使 用 Web 浏览 功能 的 Android 应 
用 程序 都 要 创建 该 视图 对 象 以 显示 和 处 理 请 求 的 网 络 资源 。 目 前 ，WebKit 模块 支持 HTTP. 
HTTPS, FTP 以 及 JavaScript 请 求 。WebView 作为 应 用 程序 的 UI 接口 ， 为 用 户 提供 了 一 系列 
的 网 页 浏览 、 用 户 交 互 接口 ， 客 户 程序 通过 这 些 接口 访问 WebKit 核心 代码 。 

(2) WebViewDatabase 

类 WebViewDatabase 是 WebKit 模块 中 针对 SQLiteDatabase 对 象 的 封装 ,用 于 存储 和 获取 
浏览 器 运行 时 保存 的 缓冲 数据 、 历 史 访 问 数据 、 浏 览 器 配置 数据 等 。 该 对 象 是 一 个 单 实例 对 
象 , 通过 getInstance 方法 获取 WebViewDatabase 的 实例 。WebViewDatabase 是 WebKit 模块 中 
的 内 部 对 象 ， 仅 供 WebKit 框架 内 部 使 用 。 

(3) WebViewCore 

类 WebViewCore 是 Java BCE WebKit 核心 库 的 交互 类 ， 客 户 程序 调用 WebView 的 
网 页 浏览 相关 操作 转发 给 BrowserFrame 对 象 。 当 WebKit 核心 库 完成 实际 的 数据 分 析 和 处 理 
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后 会 回调 WebViweCore 中 定义 的 一 系列 JNI 接口 , 这 些 接口 会 通过 类 CallbackProxy (代理 类 ) 
将 相关 事件 通知 相应 的 UI 对 象 。 
(4) CallbackProxy 
类 CallbackProxy 是 一 个 代理 类 ， 用 于 实现 UI 线程 和 WebCore 线程 之 间 的 交互 。 类 
CallbackProxy 定义 了 一 系列 与 用 户 相关 的 通知 方法 ， 当 WebCore 完成 相应 的 数据 处 理 后 会 调 
J] CallbackProxy 类 中 对 应 的 方法 , 这 些 方法 通过 消息 的 方式 间接 调用 相应 的 处 理 对 象 的 方法 。 
(5) BrowserFrame 
类 BrowserFrame 负责 URL 资源 的 载 入 、 访 问 历 史 的 维护 、 数 据 缓 存 等 操作 ， 该 类 会 通 
过 JNI 接 口 直接 与 WebKit 的 C 层 库 进行 交互 。 
(6) JWebCoreJavaBridge 
类 JWebCoreJavaBridge 的 功能 是 ， 为 Java JÆ WebKit 代码 提供 了 与 C E WebKit 核心 部 
分 的 Timer 〈 计 时 模块 ) 和 Cookies (Cookies 身份 验证 模块 ) 操作 相关 的 方法 。 
(7) DownloadManagerCore 
类 DownloadManagerCore 是 一 个 下 载 管理 核心 类 ， 主 要 负责 网 络 资源 的 下 载 管 理 ， 所 有 
的 Web 下 载 操 作 均 由 该 类 统一 管理 。 该 类 实例 运行 在 WebKit 线程 当中 ,与 UI 线程 的 交互 是 
通过 调用 CallbackProxy 对 象 中 相应 的 方法 完成 。 
(8) WebSettings 
类 WebSettings 描述 了 Web 浏览 器 访问 相关 用 户 的 配置 信息 。 
9) DownloadListener 
类 DownloadListener 负责 实现 侦 听 下 载 操作 事件 的 接口 ， 如 果 客 户 代 码 实现 该 接口 ， 则 
在 下 载 开始 台 、 失 败 、 挂 起 、 完成 等 情况 下 ，DownloadManagerCore 对 象 会 调用 客户 代码 中 实 
现 的 DwonloadListener 方法 。 
ned WebBackForwardList 
类 WebBackForwarList 负责 维护 用 户 访问 的 历史 记录 ， 该 类 为 客户 程序 提供 操作 访问 浏 
览 器 历史 数据 的 相关 方法 
(11) WebViewClient 
在 类 WebViewClient 中 定义 了 一 系列 事件 方法 ， 如 果 Android 应 用 程序 设置 了 
WebViewClient 派生 对 象 ， 则 在 页 面 载 入 、 资 源 载 入 、 页 面 访 问 错误 等 情况 发 生 时 ， 该 派生 对 
象 的 相应 方法 会 被 调用 。 
(12) WebBackForwardListClient 
类 WebBackForwardListClient 定义 了 对 访问 历史 操作 时 可 能 产生 的 事件 接口 ， 当 用 户 实 
现 了 该 接口 ， 则 在 操作 访问 历史 时 《访问 历史 移 除 、 访 问 历 史 清 空 等 ) 用 户 会 得 到 通知 。 
(13) WebChromeClient 
类 WebChromeClient 定义 了 与 浏览 窗口 修饰 相关 的 事件 ,例如 接收 到 Title、 接 收 到 ICON、 
进度 变化 时 ，WebChromeClient 的 相应 方法 会 被 调用 。 


71.2 ”使 用 内 置 浏 览 器 打开 网 页 


在 Android 系统 中 有 一 个 内 置 浏览 器 ， 通 过 这 个 内 置 浏览 器 可 以 打开 网 页 。 在 下 面 的 实 
例 中 定义 了 一 个 ListView 控件 ， 在 里 面 的 列表 中 显示 了 4 个 菜单 ， 单 击 菜 单 后 会 连接 到 指定 
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内 置 的 浏览 器 ， 并 浏览 ListView 中 创建 的 网 页 U URL. 
题 H 的 源码 路 径 
实例 7-1 使 用 内 置 浏览 器 打开 网 页 daima\7\nei 


编写 主 程序 文件 ， 其 具体 实现 流程 如 下 。 


(1) 通过 findViewByld 构造 器 创建 ListView 与 TextView 对 象 ， 将 文件 string.xml 中 的 字 
符 串 信息 导入 到 列表 中 。 具 体 实 现代 码 如 下 ，。 


public void onCreate(Bundle savedInstanceState) 

1 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
/# 通 过 find ViewById 构造 器 创建 ListView 与 TextView XJ Ss 
mListView1 =(List View) findViewById(R.id.myListView1); 
mTextViewl = (TextView) find ViewByld(R.id.myTextView 1); 
mTextView1.setText(getResources().getString(R.string.hello)); 
上 将 列表 通过 string.xml 中 导入 */ 


myFavor = new String[] { 


getResources().getString 
(R.string.str_list_url1), 
getResources().getString 
(R.string.str_list_url2), 
getResources().getString 
(R.string.str_list_url3), 
getResources().getString 
(R.string.str_list_url4) 
h 


(2) 将 自 定 义 ArrayAdapter 对 象 中 的 信息 传 入 到 ListView 列表 中 ， 然 后 打开 ListAdapter 
的 可 选 菜单 选项 ， 最 后 设置 单 击 ListView 列表 选项 的 处 理事 件 。 有 具体 实现 代码 如 下 。 


I 


zH 


/* Axe X. ArrayAdapter 准备 传 入 ListView 中 ,并 将 myFavor 列表 以 参数 传 入 */ 
ArrayAdapter<String> adapter = new 

Array Adapter<String> 

(example4.this, android.R.layout.simple_list_item_1, myFavor); 

/*¥% EL e RMA ArrayAdapter 传 入 自 定 义 的 ListView 中 */ 
mListView1.setAdapter(adapter); 

/*¥% ListAdapter 的 可 选 菜 单 选项 打开 */ 

mListView1.setItemsCanFocus(true); 
[i ListView 六 单 选项 设 为 每 次 只 能 单一 选项 */ 
mListView1.setChoiceMode 
(ListView. CHOICE MODE SINGLE); 

3E ListView 选项 的 nItemClickListener*/ 
mListView1.setOnItemClickListener 
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1 


(3) 当 用 户 单 击 一 个 Item 选项 后 ， 进 行 比较 处 理 ， 并 从 文件 string.xml 中 读 取出 对 应 的 
URL 网 址 字符 串 ， 然 后 将 字符 串 转 换 为 URL 对 象 。 有 具体 实现 代码 如 下 。 


/*35 ih, OnItemClick 方法 */ 

public void onItemClick 

(AdapterView<?> arg0, View arg], int arg2,long arg3) 

{ 
// TODO Auto-generated method stub 
人 # 若 所 选 菜单 的 文字 与 myFavor FIFE 858 rte 4H lat 
if(arg0.getA dapter().getItem(arg2).toString()—— 


myFavor[0].toString()) 

{ 
PSU DEER goToUr10 方 法 */ 
myUrl=getResources().getString(R.string.str_url1); 
goToUrl(myUrl); 

} 

PEE BTE SE ELT Ce myFavor 字符 串 数组 第 二 个 文字 相同 */ 

else if (arg0.getAdapter().getItem(arg2).toString()—— 


myFavor[1].toString()) 

1 
/# 取 得 网 址 并 调用 goToUrl0 方 法 */ 
myUrl=getResources().getString(R.string.str_url2); 
goToUrl(myUrl); 

j 

PEE BTE SE ELT Ce myFavor 字符 串 数组 第 三 个 文字 相同 */ 

else if (arg0.getAdapter().getItem(arg2).toString()== 


myFavor[2].toString()) 

S 
PAGS DEER goToUr10 方 法 */ 
myUrl=getResources().getString(R.string.str_url3); 
goToUrl(myUrl); 

j 

人 # 若 所 选 菜单 的 文字 与 myFavor FIFE 2 58 PAP 3C 4H la 

else if (arg0.getAdapter().getItem(arg2).toString()— 


myFavor[3].toString()) 

1 
PUES DEER goToUrl() rat 
myUrl=getResources().getString(R.string.str_url4); 
goToUrl(myUrl); 

j 

zl Ek 

else 

1 


放 显 示 错 误 信 息 */ 
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mTextView1.setText("Ooops!! 出 错 了 "); 


} 


35 
} 


(4) 定义 方法 goToUrl(String ur 来 打开 网 址 为 URL 的 网 页 ， 具 体 实现 代码 如 下 。 


庶 打 开 网 页 的 方法 */ 

private void goToUrl(String url) 

{ 
Uri uri = Uri.parse(url); 
Intent intent = new Intent(Intent. ACTION VIEW, uri); 
startActivity(intent); 


j 


执行 后 列表 将 显示 4 NRE, WE 7-1 所 示 。 当 单 击 一 个 菜单 后 ， 会 跳 转 到 对 应 的 目 
标 页 面 。 


图 7-1 4 个 菜单 


7.2 Android 5.0 中 的 WebView 


文件 WebView.java 实现 了 类 WebView， 此 类 是 WebKit 模块 Java 层 的 视图 类 ， 所 有 需要 
使 用 Web 浏览 功能 的 Android 应 用 程序 都 要 创建 该 视图 对 象 以 显示 和 处 理 请 求 的 网 络 资源 。 
目前 ，WebKit 模块 支持 HTTP. HTTPS, FTP 以 及 JavaScript 请 求 。 从 Android 5.0 开始 ， 引 
入 了 Mixed Content (RICA AEA) 模式 和 第 三 方 Cookie。 在 本 节 的 内 容 中 ， 将 详细 讲解 
Android 5.0 系统 中 WebView 的 核心 架构 知识 ， 为 读者 深入 理解 Android 网 络 系统 的 架构 打下 
基础 。 


1.234 WebView 架构 基础 


在 Android 5.0 系统 中 ， 文 件 WebView.java 是 一 个 内 置 的 支持 浏览 器 的 视图 View， 此 文 
件 位 于 如 下 的 目录 中 : 


frameworks\base\core\java\android\webkit 
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WebView 作为 应 用 程序 的 UI 接口 ， 为 用 户 提 供 了 一 系列 的 网 页 浏览 、 用 户 交 互 接口 ， 
客户 程序 通过 这 些 接 口 访问 WebKit 核心 代码 。WebView 实现 了 WebKit 的 最 核心 功能 。 近 年 
来 随 着 用 户 对 网 络 安全 的 重视 ,谷歌 公司 为 了 创建 一 个 安全 、 稳 定 和 快速 的 通用 浏览 器 系统 ， 
特意 推出 了 Chromium 引擎 驱动 ， 这 也 是 谷歌 官方 浏览 器 Chrome 的 引擎 驱动 。 在 全 新 的 
Android 5.0 系统 中 ，WebView 将 开始 采用 Chromium 引擎 驱动 。 

浏览 Android 5.0 源码 时 会 发 现 ， 之 前 版 本 中 的 “external/WebKit” 目 录 已 经 被 移 除 掉 ， 
取而代之 的 是 “chromium org". 由 此 可 见 Chromium 已 经 完全 取代 了 之 前 的 WebKit for 
Android. AR Chromium 完全 取代 了 以 前 的 WebKit for Android， 但 是 Android WebView 的 
API 接口 并 没有 变 ， 与 老 的 版 本 完全 兼容 。 这 样 带 来 的 好 处 是 基于 WebView 构建 的 APP， 无 
需 做 任何 修改 即 可 享受 Chromium 内 核 的 高 效 与 强大 。 

在 Android 5.0 系统 中 , “frameworks/base/core/java/android/webkit” 目 录 下 的 各 个 文件 如 
图 7-2 所 示 。 


|j BrowserDownloadListener. java |; WebBackForwardList. java 

| .|CacheManager. java |j WebBackForwardListClient. java 
| |ConsoleMessage. java |] WebChromeClient. java 

| jCooki eManager. java |; WebHi storyItem. java 

|; Cooki eSynclManager. java |; WebIconDatabase. java 

| jDateSorter. java | WebResourceResponse. java 

|. DebugFlags. java | WebSettings. java 

|; DownloadListener. java | WebStorage. java 

| ]EventLogTags. logtags 国 WebSyncManager. java 


|; FindActionModeCallback. java | WebView. java 


|; GeolocationPermissions. java |; WebVi ewClient. java 

|j HttpAuthHandler. java | WebViewDatabase. java 

|_| JavascriptInterface. java | WebViewFactory. java 

|. JsDi alogHelper. java |] WebVi ewFactoryProvider. java 
|] JsPromptResult. java 国 WebVi ewFragnent. java 

|j JsResult. java | WebViewProvider. java 


| MimeTypeħap. java 

| MustOverrideException. java 
&) package. html 

|j Plugin. java 

| PluginData. java 

|j FluginList. java 

|. PluginStub. java 

|j SslErrorHandler. java 

|j UrlInterceptHandler. java 
__|UrlInterceptRegistry. java 
|] VRLUtil. java 

|. ValueCallback. java 


图 7-2 “frameworks/base/core/java/android/webkit” Hae FC 


fr Android 5.0 中 ， 设 计 者 设计 出 了 一 个 WebViewProvider 接口 ，WebView 本 身 并 不 实 
现 具体 的 功能 ， 而 是 将 所 有 的 处 理 功能 交 给 WebViewProvider 来 实现 。 而 WebViewProvider 
只 是 一 个 接口 ， 至 于 具体 的 解决 方案 由 实现 者 来 决定 到 底 采 用 哪 一 种 引擎 。 其 实 从 Android 
4.1 系统 开始 就 采用 了 这 种 架构 模式 ， 这 说 明 谷 歌 那 时 便 已 经 开始 为 以 Chromium 为 驱动 的 
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WebView 做 准备 。Android 5.0 之 前 的 版 本 ， 
LH. Android 5.0 系统 中 ， 则 通过 WebViewChromium 实现 WebViewProvider 接口 。 
采用 了 相似 的 结构 ， 设 置 了 实例 化 WebViewFactoryProvider 的 具体 策 


WebViewFactory 也 


Ho E WebViewFactoryProvider 中 有 


WebViewProvider. 


Android 5.0 中 WebView 的 代码 结构 如 


由 此 可 见 ， 传 统 的 基 


"aX 


d 


通过 WebViewClassic 实现 WebViewProvider 4 


个 十 分 关键 的 接口 createWebView， 功 能 是 创建 具体 的 


图 7-3 所 示 。 
LF AOSP master 架构 由 WebKit 实现 的 仍然 保留 ， 因 为 采用 了 灵活 的 


架构 ， 所 以 可 以 在 AOSP 和 Chromium 两 种 核心 之 间 非 常 容易 切换 。 

在 Content API Z E, Chromium 的 WebView 实现 封装 了 一 个 新 的 类 AwContents, 该 类 主 
要 基于 ContentViewCore 类 的 实现 , 不同 的 是 , AwContents 需要 基于 一 个 原来 存在 于 “chrome/” 
目录 下 的 模块 (图 7-3 中 的 Browser Components)， 但 是 AwContents 不 应 该 依赖 该 目录 ， 所 


以 ,将 Chrome 中 的 一 些 


“功能 实现 模块 化 处 到 


模块 已 经 从 Chrome F$ 


HB T. Ri 


因为 在 AwContent 


项 目的 AwContents 模块 来 实现 。 整 体 模块 架构 如 


We 66 
pu 


是 Chromium 的 一 个 发 展 方 向 。 目 前 ， 一 些 功能 


components/”. 


s 中 提供 的 不 是 WebView 的 API， 所 以 需要 借助 中 间 桥 接 层 ， 将 
AwContents 桥接 到 WebView， 这 就 是 上 图 中 的 桥接 模块 ， 该 模块 位 于 Android 5.0 源 代码 中 的 
“ frameworks/webview/chromium/java/com/android/webview/chromium/" H 3K Fo 2$ WebView 
Chromium 和 类 WebViewChromiumFactory 作为 WebView 的 具体 实现 ,需要 依赖 于 Chromium 


android.webkit WebView 
Android AOSP Bridee from AwContents to WebView 


Chromium Project 


图 7-3 Android 5.0 中 WebView 的 代码 结构 


图 7-4 所 示 。 


ChromiumWebView 
AwContents 


WebKit Glue 


Blink 
Blink Port 


图 7-4 AwContents 模块 的 架构 图 


AwContents 基于 Content 之 上 ， 专 门 针 对 WebView 的 需求 进行 封装 ， 这 个 封装 只 是 针对 


Android 平台 实现 。 同 样 道 青 


E, WebView 也 是 基于 Content API (Web Contents 和 


ContentViewCore 等 ) 之 上 的 ， 这 一 点 它 同 Content Shell 和 Chromium 浏览 器 没有 大 的 不 同 ， 
区 别 在 于 它们 对 很 多 Delegate 类 的 实现 不 同 , 这 是 Content API 用 于 让 使 用 者 参与 内 部 逻辑 和 


实现 的 过 程 。 有 具体 来 说 ， 
C1) 演 染 机 制 


因为 WebView 提供 


中 的 结构 ， 例 如 bitmap, 
180 mE 


主要 有 以 下 两 个 方面 的 不 同 。 


t 的 是 一 个 View 控件 ， 所 以 View 控件 的 容器 可 能 会 接受 储存 在 CPU 
也 可 能 是 储存 在 GPU 内 存 中 的 结构 ， 例 如 surface， 所 以 它 需 要 提供 


两 种 不 同 的 输出 结果 。 
Chromium 引入 了 一 种 新 的 
内 存 的 两 种 方式 。 对 于 Compos 


实现 有 关 的 代码 不 多 ， 只 有 文人 
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合成 器 UberCompositort+， 该 合成 器 支持 输出 到 GPU 和 CPU 
itor 的 结果 输出 到 给 定 View 的 GPU 内 存 的 这 种 方式 来 说 ， 关 


键 点 在 于 实现 AwContents.InternalAccessDelegate 接口 的 requestDrawGL 方法 ,与 requestDrawGL 


F DrawGLFunctor.java 和 文件 GraphicsUtils.java， 还 有 与 之 关联 


的 本 地 实现 文件 draw. gl functorcpp. raphic buffer impl.cpp 和 graphics_utils.cpp， 本 地 代码 位 
T *frameworks/webview/chromium/plat support” 目 录 下 ， 此 部 分 并 不 仅 使 用 了 Android SDK 


和 NDK 的 API， 而 且 也 涉及 到 
(2) 进程 

目前 WebView 只 文 持 单 进 

用 Android 的 isolated UID 机 制 


了 Android 源码 。 


程 ， 未 来 版 本 应 该 文 持 多 进程 方式 。 单 进程 意味 着 没有 办 法 使 
， 因 此 ， 某 种 程度 上 来 讲 ， 安 全 性 降低 了 ， 而 且 页 面 的 泻 染 崩 


省会 导致 使 用 WebView 的 应 用 程序 朋 溃 。 


1.22 WebView 类 简介 


在 Android 5.0 系统 中 ，WebView 类 的 实现 文件 WebView.java 位 于 如 下 的 目录 中 。 


frameworks\base\core\java\android\webkit 


类 WebView 继承 于 AbsoluteLayout, SC EN OnGlobalFocusChangeListener 和 OnHierarchy 
ChangeListener, 2$ WebView 的 构造 函数 的 具体 实现 代码 如 下 。 


@SuppressWarnings("deprecation") 
uper() call into deprecated base class 
protected WebView(Context co 


constructor. 
ntext, AttributeSet attrs, int defStyle, 


Map<String, Object> javaScriptInterfaces, boolean privateBrowsing) { 


super(context, attrs, defSty: 
if (context == null) { 


le); 


throw new IllegalArgumentException("Invalid context argument"); 


j 


sEnforceThreadChecking = context.getApplicationInfo().targetSdk Version >= 
Build. VERSION _CODES.JELLY BEAN MR2; 


checkThread(); 


if (DebugFlags. TRACE API) Log.d(LOGTAG, "WebView<init>"); 


ensureProviderCreated(); 


mProvider.init(javaScriptInterfaces, privateBrowsing); 


CookieSyncManager.setGetInstanceIsAllowed(); 


j 


public void addJavascriptInterface(Object object, String name) { 


checkThread(); 


if (DebugFlags. TRACE API) Log.d(LOGTAG, "addJavascriptInterface-" + name); 


mProvider.addJavascriptIn 


} 
public boolean canGoBack() { 


terface(object, name); 
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checkThread(); 
return mProvider.canGoBack(); 


} 
public boolean canGoBackOrForward(int steps) { 
checkThread(); 
return mProvider.canGoBackOrForward(steps); 
} 
public void goForward() { 
checkThread(); 
if (DebugFlags. TRACE API) Log.d(LOGTAG, "goForward"); 
mProvider.goForward(); 
j 
public boolean canZoomlIn() { 
checkThread(); 
return mProvider.canZoomIn(); 
} 


/注入 所 提供 的 Java 对 象 到 这 个 Web 视图 
public void addJavascriptInterface(Object object, String name) { 
checkThread(); 
if (DebugFlags. TRACE API) Log.d(LOGTAG, "addJavascriptInterface=" + name); 
mProvider.addJavascriptInterface(object, name); 


} 
/获取 此 的 WebView 是 否 有 背 历史 的 项 目 
public boolean canGoBack() { 
checkThread(); 
return mProvider.canGoBack(); 


} 
/获取 页 面 是 否 可 以 回去 或 转发 的 步骤 给 定数 量 
public boolean canGoBackOrForward(int steps) { 
checkThread(); 
return mProvider.canGoBackOrForward(steps); 


m 


} 
/获取 此 的 WebView 是 否 有 历史 前 进 的 项 目 
public void goForward() { 
checkThread(); 
if (DebugFlags. TRACE API) Log.d(LOGTAG, "goForward"); 
mProvider.goForward(); 


} 
/获取 此 的 WebView 是 否 可 以 将 其 放大 
public boolean canZoomlIn() { 
checkThread(); 
return mProvider.canZoomIn(); 


j 
/告诉 这 个 Web 视图 ， 以 清除 其 内 部 的 前 进 /后 退 清单 
public void clearHistory() { 
checkThread(); 
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if (DebugFlags. TRACE API) Log.d(LOGTAG, "clearHistory"); 


mProvider.clearHistory(); 


j 
/获取 第 一 个 子 串 组 成 的 物理 位 置 的 地 址 
public static String findAddress(String addr) { 
return getFactory().getStatics().findA ddress(addr); 


j 
/获取 的 HTML 内 容 的 高 度 
public int getContentHeight() { 
checkThread(); 
return mProvider.getContentHeight(); 
} 
/获取 当前 页 面 的 原始 URL 
public String getOriginalUrl() { 
checkThread(); 
return mProvider.getOriginalUrl(); 


} 
/获取 当前 页 面 的 进度 
public int getProgress() { 
checkThread(); 
return mProvider. getProgress(); 


1.2.3 WebViewProvider 接口 


接口 WebViewProvider 的 实现 文件 是 WebViewProviderjava, 1E H 


主要 实现 代码 如 下 。 


public interface WebViewProvider { 

public void init(Map<String, Object> javaScriptInterfaces, 
boolean privateBrowsing); 

public void setHorizontalScrollbarOverlay(boolean overlay); 

public void setVerticalScrollbarOverlay(boolean overlay); 

public boolean overlayHorizontalScrollbar(); 

public boolean overlay VerticalScrollbar(); 

public int getVisibleTitleHeight(); 

public SslCertificate getCertificate(); 

public void setCertificate(SslCertificate certificate); 

public void savePassword(String host, String username, String password); 

public void setHttpAuthUsernamePassword (String host, String realm, 
String username, String password); 

public String[] getHttpAuthUsernamePassword(String host, String realm); 

public void destroy(); 

public void setNetworkA vailable(boolean networkUp); 

public WebBackForwardList saveState(Bundle outS tate); 

public boolean savePicture(Bundle b, final File dest); 


WebKit 浏览 网 页 


面 定义 了 很 多 接口 函数 ， 
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public boolean restorePicture(Bundle b, File src); 
public WebBackF orwardList restoreState(Bundle inState); 
public void loadUrl(String url, Map<String, String> additionalHttpHeaders); 
public void loadUrl(String url); 
public void postUrl(String url, byte[] postData); 
public void loadData(String data, String mimeType, String encoding); 
public void loadDataWithBaseURL(String baseUrl, String data, 
String mimeType, String encoding, String historyUrl); 
public void evaluateJavaScript(String script, ValueCallback<String> resultCallback); 
public void saveWebArchive(String filename); 
public void saveWebArchive(String basename, boolean autoname, ValueCallback<String> callback); 
public void stopLoading(); 
public void reload(); 
public boolean canGoBack(); 
public void goBack(); 
public boolean canGoForward(); 
public void goForward(); 
public boolean canGoBackOrForward(int steps); 
public void goBackOrForward(int steps); 
public boolean isPrivateBrowsingEnabled(); 
public boolean pageUp(boolean top); 
public boolean pageDown(boolean bottom); 
public void clearView(); 
public Picture capturePicture(); 
public PrintDocumentAdapter createPrintDocumentA dapter(); 
public float getScale(); 
public void setInitialScale(int scaleInPercent); 
public void invokeZoomPicker(); 
public HitTestResult getHitTestResult(); 
public void requestFocusNodeHref(Message hrefMsg); 
public void requestImageRef(Message msg); 
public String getUrl(); 
public String getOriginalUrl(); 
public String getTitle(); 
public Bitmap getFavicon(); 
public String getTouchIconUrl(); 
public int getProgress(); 
public int getContentHeight(); 
public int getContentWidth(); 
public void pauseTimers(); 
public void resumeTimers(); 
public void onPause(); 
public void onResume(); 
public boolean isPaused(); 
public void freeMemory(); 
public void clearCache(boolean includeDiskFiles); 
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public void clearFormData(); 
public void clearHistory(); 
public void clearSs|Preferences(); 
public WebBackForwardList copyBackForwardList(); 
public void setFindListener(WebView.FindListener listener); 
public void findNext(boolean forward); 
public int findAll(String find); 
public void findAllAsync(String find); 
public boolean showFindDialog(String text, boolean showlIme); 
public void clearMatches(); 
public void documentHasImages(Message response); 
public void setWebViewClient(WebViewClient client); 
public void setDownloadListener(DownloadListener listener); 
public void setWebChromeClient(WebChromeClient client); 
public void setPictureListener(PictureListener listener); 
public void addJavascriptInterface(Object obj, String interfaceName); 
public void removeJavascriptInterface(String interfaceName); 
public WebSettings getSettings(); 
public void setMapTrackballToArrowKeys(boolean setMap); 
public void flingScroll(int vx, int vy); 
public View getZoomControls(); 
public boolean canZoomlIn(); 
public boolean canZoomOut(); 
public boolean zoomIn(); 
public boolean zoomOut(); 
public void dumpViewHierarchy WithProperties(BufferedWriter out, int level); 
public View findHierarchy View(String className, int hashCode); 
public boolean shouldDelayChildPressedState(); 
public AccessibilityNodeProvider getAccessibilityNodeProvider(); 
public void onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info); 
public void onInitializeAccessibilityEvent(AccessibilityEvent event); 
public boolean performAccessibilityAction(int action, Bundle arguments); 
public void setOverScrollMode(int mode); 
public void setScrollBarStyle(int style); 
public void onDrawVerticalScrollBar(Canvas canvas, Drawable scrollBar, int 1, int t, 
int r, int b); 
public void onOverScrolled(int scrollX, int scrollY, boolean clampedX, boolean clampedY); 
public void onWindowVisibilityChanged(int visibility); 
public void onDraw(Canvas canvas); 
public void setLayoutParams(LayoutParams layoutParams); 
public boolean performLongClick(); 
public void onConfigurationChanged(Configuration newConfig); 
public InputConnection onCreateInputConnection(EditorInfo outAttrs); 
public boolean onKeyMultiple(int keyCode, int repeatCount, KeyEvent event); 
public boolean onKeyDown(int keyCode, KeyEvent event); 
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在 Android 5.0 系统 中 ， 通 过 WebViewChromium 实现 WebViewProvider 接口 。 


男 外 ， 


WebViewFactory 也 采用 了 相似 的 结构 ， 决 定 如 何 实例 化 Ww eo CE ， 


WebViewFactoryProvider 的 关键 的 接口 是 createWebView ， 功 能 是 创建 具 
WebViewProvider。 


7.2.4 WebViewChromium 详解 


具体 的 


在 Android 5.0 系统 中 ，WebViewChromium 实现 WebViewProvider 接口 。WebViewChromium 


在 如 下 所 示 的 文件 中 定义 。 


frameworks\webview\chromium\java\com\android\webview\chromium\Web ViewChromium.java 


在 文件 Web ViewChromium.java 中 实现 了 WebViewProvider 中 各 个 方法 的 具体 功能 , E 


实现 代码 如 下 。 


public void init(final Map<String, Object> javaScriptInterfaces, 
final boolean privateBrowsing) { 
if (privateBrowsing) { 

mFactory.startY ourEngines(true); 

final String msg = "Private browsing is not supported in WebView."; 

if (mAppTargetSdkVersion >= Build. VERSION CODES.KITKAT) { 
throw new IllegalArgumentException(msg); 

} else { 
Log.w(TAG, msg); 
TextView warningLabel = new TextView(mWebView.getContext()); 
warningLabel.setText(mWebView. getContext().getString( 

com.android.internal.R.string.webviewchromium private browsing warning)); 

mWebView.addView(warningLabel); 


} 
if (mAppTargetSdk Version >= Build. VERSION CODES.JELLY BEAN MR2) { 
mFactory.startY ourEngines(false); 
checkThread(); 
} else if (!mFactory.hasStarted()) { 
if (Looper.myLooper() == Looper.getMainLooper()) { 
mFactory.startY ourEngines(true); 


} 
final boolean isAccessFromFileURLsGrantedBy Default = 
mAppTargetSdkVersion < Build. VERSION CODESJELLY BEAN; 
final boolean areLegacyQuirksEnabled = 
mAppTargetSdkVersion < Build. VERSION CODES.KITKAT; 
mContentsClientAdapter = new WebViewContentsClientAdapter(mWebView); 
mWebSettings = new ContentSettingsAdapter(new AwSettings( 
mWebView.getContext(), isAccessFromFileURLsGrantedByDefault, 
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areLegacyQuirksEnabled)); 
mRunQueue.addTask(new Runnable() { 
@Override 
public void run() { 
initForReal(); 
if (privateBrowsing) { 
destroy(); 


Di 
} 
private void initForReal() { 
mAwContents = new AwContents(mFactory.getBrowserContext(), mWebView, 
new InternalAccessAdapter(), mContentsClientAdapter, new AwLayoutSizer(), 
mWebSettings. getA wSettings()); 
if (mAppTargetSdk Version >= Build. VERSION CODES.KITKAT) { 
AwContents.setShouldDownloadFavicons(); 


} 
void startYourEngine() { 
mRunQueue.drainQueue(); 
} 
private RuntimeException createThreadException() { 
return new IllegalStateException( 
"Calling View methods on another thread than the UI thread."); 


I 


上 面具 是 列 出 了 几 个 方法 ， 有 具体 内 容 读 者 可 以 参阅 Android 5.0 的 源码 。 在 Android 5.0 


系统 中 ，WebViewChromium 通过 调用 Chromium 项 目的 AwContents 模块 来 实现 具体 功能 。 


7.2.5 WebViewChromiumFactoryProvider 详解 


在 Android 5.0 系统 中 ， 文 件 WebViewChromiumFactoryProviderjava 的 功能 是 实例 化 


WebViewFactoryProvider， 此 文件 位 于 如 下 的 目录 中 。 


frameworks\webview\chromium\java\com\android\webview\chromium\ 


TN 


文件 WebViewChromiumFactoryProviderjava tH, F] fi 
AwContents 模块 来 实现 具体 功能 ， 主 要 实现 代码 如 下 。 


private void ensureChromiumStartedLocked(boolean onMainThread) { 
assert Thread.holdsLock(mLock); 
if (mStarted) { 
return; 


} 
Looper looper = !onMainThread ? Looper.myLooper() : Looper.getMainLooper(); 


需要 依赖 于 Chromium 项 目的 
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Log.v("WebViewChromium", "Binding Chromium to the " + 
(onMainThread ? "main":"background") + " looper " + looper); 
ThreadUtils.setUiThread(looper); 
if (ThreadUtils.runningOnUiThread()) { 
startChromiumLocked(); 
return; 
} 
/通过 CookieManager 实现 线程 安全 的 方式 启动 Chromium 
ThreadUtils.postOnUiThread(new Runnable() { 
@Override 
public void run() { 
synchronized (mLock) { 


startChromiumLocked(); 
} 
} 
Di 
while (!mStarted) { 
try { 
mLock.wait(); 
} catch (InterruptedException e) { 
/继续 尝试 … 最 终 用 户 界面 将 处 理 我 们 发 送 的 任务 
} 
} 


} 
private void startChromiumLocked() { 
assert Thread.holdsLock(mLock) && ThreadUtils.runningOnUiThread(); 
/通知 返回 路 径 
mLock.notifyAll(); 
if (mStarted) { 


return; 


} 

if (Build.IS DEBUGGABLE) { 
CommandLine.initFromFile(COMMAND LINE FILE); 

} else { 
CommandLine.init(null); 

j 

CommandLine cl = CommandLine.getInstance(); 

cl.appendSwitch("enable-dcheck"); 

if (!cl.hasSwitch("disable-webview-gl-mode")) { 
cl.appendSwitch("testing-webview-gl-mode"); 

} 

Context context = ActivityThread.currentA pplication(); 

if (context.getA pplicationInfo().targetSdk Version < Build. VERSION CODES.KITKAT) { 
cl.appendSwitch("enable-webview-classic-workarounds"); 

j 

/无 须 提 取 额 外 的 系统 图 像 
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ResourceExtractor.setMandatoryPaksToExtract(""); 
try 1 
LibraryLoader.ensureInitialized(); 
} catch(ProcessInitException e) { 
throw new RuntimeException("Error initializing WebView library", e); 
} 
PathService.override(PathService.DIR MODULE, "/system/lib/"); 
final int DIR RESOURCE PAKS ANDROID = 3003; 
PathService.override(DIR RESOURCE PAKS ANDROID, 
"/system/framework/webview/paks"); 
AwBrowserProcess.start(Activity Thread.currentA pplication()); 
initPlatSupportLibrary(); 
if (Build.IS DEBUGGABLE) { 
setWebContentsDebuggingEnabled(true); 
} 
mStarted = true; 
for (WeakReference<WebViewChromium> wvc : mWebViewsToStart) { 
WebViewChromium w = wvc.get(); 
if (w != null) { 
w.startY ourEngine(); 


j 
mWebViewsToStart.clear(); 
mWebViewsToStart = null; 
j 
@Override 
public Statics getStatics() { 
synchronized (mLock) { 
if (mStaticMethods == null) { 
ensureChromiumStartedLocked(true); 
mStaticMethods = new WebViewFactoryProvider.Statics() { 
@Override 
public String findAddress(String addr) { 
return ContentViewStatics.findAddress(addr); 
j 
@Override 
public void setPlatformNotificationsEnabled(boolean enable) { 
} 
@Override 
public String getDefaultUserA gent(Context context) { 
return AwSettings.getDefaultUserAgent(); 
} 
@Override 
public void setWebContentsDebuggingEnabled(boolean enable) { 
if (Bud IS DEBUGGABLE) { 
WebViewChromiumFactoryProvider.this. 
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setWebContentsDebuggingEnabled(enable); 


} 
return mStaticMethods; 


7.2.6 AwContents 架构 

在 Content API Z. E, Chromium 的 WebView 封装 了 一 个 新 的 类 AwContents， 该 类 主要 基 
于 ContentViewCore 类 的 实现 。 不 同 的 是 ，AwContents 需要 基于 一 个 原来 存在 于 “chrome/” 目 
录 下 的 模块 BrowserComponents。 但 是 因为 AwContents 不 应 该 依赖 该 目录 ， 所 以 将 Chrome 
中 的 一 些 浏览 器 模块 化 是 Chromium 的 一 个 发 展 方向 。 

AwContents 模块 的 实现 文件 是 AwContents.java， 在 如 下 的 目录 中 实现 。 


external\chromium_org\android_webview\java\src\org\chromium\android_webview\ 


因为 在 文件 AwContents.java 中 没有 实现 WebView API 的 任何 源码 , 所 以 接 下 来 需要 使 用 
桥接 层 将 AwContents 连接 到 WebView。 文 件 AwContents.java 的 主要 实现 代码 如 下 。 


@JNINamespace("android_webview") 
public class AwContents { 
private static final String TAG = "AwContents"; 
private static final String WEB ARCHIVE EXTENSION = "mht"; 
/避免 在 输出 时 发 生 缩 放 
private static final float ZOOM CONTROLS EPSILON = 0.007£ 
public static class HitTestData { 


public int hitTestResultType; 
public String hitTestResultExtraData; 
/用 在 requestFocusNodeHref 和 requestImageRef 


public String href; 
public String anchorText; 
public String imgSrc; 
} 
public AwContents(AwBrowserContext browserContext, ViewGroup containerView, 
InternalAccessDelegate internalAccessAdapter, AwContentsClient contentsClient, 
boolean isAccessFromFileURLsGrantedByDefault, AwLayoutSizer layoutSizer, 
boolean supportsLegacyQuirks) { 
this(browserContext, containerView, internalAccessAdapter, contentsClient, 
layoutSizer, new AwSettings(containerView.getContext(), 
isAccessFromFileURLsGrantedByDefault, supportsLegacyQuirks)); 
j 
public AwContents(AwBrowserContext browserContext, ViewGroup containerView, 
InternalAccessDelegate internalAccessAdapter, AwContentsClient contentsClient, 
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AwLayoutSizer layoutSizer, AwSettings settings) { 
mBrowserContext = browserContext; 
mContainerView = container View; 
minternalAccessA dapter = internalAccessA dapter; 
mContentsClient = contentsClient; 
mLayoutSizer = layoutSizer; 
mSettings = settings; 
mDIPScale = DeviceDisplayInfo.create(mContainerView.getContext()).getDIPScale(); 
mLayoutSizer.setDelegate(new AwLayoutSizerDelegate()); 
mLayoutSizer.setDIPScale(mDIPScale); 
mWebContentsDelegate = new AwWebContentsDelegateA dapter(contentsClient, mContainerView); 
mContentsClientBridge = new AwContentsClientBridge(contentsClient); 
mZoomControls = new AwZoomControls(this); 
mloThreadClient = new IoThreadClientImpl(); 
minterceptNavigationDelegate = new InterceptNavigationDelegateImpl(); 
AwsSettings.ZoomSupportChangeListener zoomListener = 
new AwSettings.ZoomSupportChangeListener() { 
@Override 
public void onGestureZoomSupportChanged(boolean supportsGestureZoom) { 
mContentViewCore.updateMulti TouchZoomSupport(supportsGestureZoom); 
mContentViewCore.updateDoubleTapDragSupport(supportsGestureZoom); 


h 
mSettings.setZoomListener(zoomListener); 
mDefaultVideoPosterR equestHandler = new DefaultVideoPosterRequestHandler(mContentsClient); 
mSettings.setDefault VideoPosterURL( 
mDefaultVideoPosterRequestHandler.getDefaultVideoPosterURL()); 
mSettings.setDIPScale(mDIPScale); 
mScrollOffsetManager = new AwScrollOffsetManager(new AwScrollOffsetManagerDelegate(), 
new OverScroller(mContainerView.getContext())); 
setOverScrollMode(mContainerView.getOverScrollMode()); 
setScrollBarStyle(mInternalAccessA dapter.super getScrollBarStyle()); 
mContainerView.addOnLayoutChangeListener(new AwLayoutChangeListener()); 
setNewAwContents(nativeInit(mBrowserContext)); 
onVisibilityChanged(mContainerView, mContainerView.getVisibility()); 
onWindowVisibilityChanged(mContainer View. get Window Visibility()); 
} 
A "ck 
* AwContents 实例 的 初始 化 
private void setNewAwContents(int newAwContentsPtr) { 
if (mNativeAwContents != 0) { 
destroy(); 
mContentViewCore = null; 


} 


assert mNativeAwContents — 0 && mCleanupReference — null && mContentViewCore = null; 
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j 


[** 


* 呼叫 "source" AwContents， 打 开 一 个 弹出 式 


+) 


mNativeAwContents = newAwContentsPtr; 

/ 绑 定 所 有 信息 到 本 机 

mCleanupReference = new CleanupReference(this, new DestroyRunnable(mNativeA wContents)); 
int nativeWebContents = nativeGetWebContents(mNative A wContents); 
mContentViewCore = createAndInitializeContent ViewCore( 


mContainerView, mInternalAccessAdapter, nativeWebContents, 
new AwGestureStateListener(), mContentsClient.getContentViewClient(), 
mZoomControls); 

nativeSetJavaPeers(mNativeAwContents, this, mWebContentsDelegate, mContentsClientBridge, 
mloThreadClient, mInterceptNavigationDelegate); 

mContentsClient.install WebContentsObserver(mContentV iewCore); 

mSettings.setWebContents(nativeWebContents); 

nativeSetDipScale(mNative AwContents, (float) mDIPScale); 

updateGlobalVisibleRect(); 

mContentViewCore.onShow(); 


Ll 


ei 


public void supplyContentsForPopup(AwContents newContents) { 


} 


int popupNativeA wContents = nativeReleasePopupA wContents(mNativeAwContents); 
if (popupNativeAwContents == 0) { 
Log.w(TAG, "Popup WebView bind failed: no pending content."); 
if (newContents != null) newContents.destroy(); 
return; 
} 
if (newContents — null) { 
nativeDestroy(popupNativeA wContents); 
return; 


j 


newContents.receivePopupContents(popupNativeA wContents); 


private void receivePopupContents(int popupNativeAwContents) ( 
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// 保 存 现 有 视图 状态 
final boolean wasAttached = mIsAttachedToWindow; 
final boolean wasViewVisible = mIsViewVisible; 


final boolean wasWindowVisible = mIsWindowVisible; 
final boolean wasPaused = mlsPaused; 

final boolean wasFocused = mContainerViewFocused; 

final boolean wasWindowFocused = mWindowFocused; 

// 处 理 现 有 的 mContentViewCore fl! mNativeAwContents. 
if (wasFocused) onFocusChanged(false, 0, null); 


if (wasWindowFocused) onWindowFocusChanged (false); 
if (was ViewVisible) setView Visibility Internal (false); 

if (wasWindowVisible) setWindowVisibilityInternal(false); 
if (!wasPaused) onPause(); 
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/处 理 GL 资源 
setNewAwContents(popupNativeA wContents); 
/刷新 所 有 的 视图 状态 
if (!wasPaused) onResume(); 
if (wasAttached) onAttachedToWindow(); 
onSizeChanged(mContainerView.getWidth(), mContainerView.getHeight(), 0, 0); 
if (wasWindowVisible) setWindowVisibilityInternal(true); 
if (was ViewVisible) set View Visibility Internal(true); 
if (wasWindowFocused) onWindowFocusChanged(was WindowFocused); 


if (wasFocused) onFocusChanged(true, 0, null); 


A LES 
* ENR HG E S B SH Fal AS 
Si 
public void destroy() { 
if (mCleanupReference != null) { 
mContentViewCore.destroy(); 
mNativeAwContents = 0; 
if (mIsAttachedToWindow) { 
if (mPendingDetachCleanupReferences == null) { 
mPendingDetachCleanupReferences = new ArrayList<CleanupReference>(); 
j 
mPendingDetachCleanupReferences.add(mCleanupReference); 
} else { 
mCleanupReference.cleanupNow(); 
j 
mCleanupReference = null; 
j 
assert !mContentViewCore.isAlive(); 
assert mNativeAwContents == 0; 


j 


由 此 可 见 ，AwContents 和 之 前 版 本 的 WebView 是 一 个 概念 ， 用 于 存放 网 页 泻 染 的 结果 。 
并 且 AwContents 都 是 基于 Android SDK/NDK 开发 ， 并 没有 使 用 Android Source 中 未 公开 的 
API 和 库 。 


7.2.7 SCE Mixed Content 模式 


TE Android 5.0 的 WebView 系 统 中 , 将 通过 函数 setMixedContentMode fll getMixedContentMode 
实现 网 页 的 Mixed Content fix. ek setMixedContentMode 和 getMixedContentMode 在 文件 
platform/frameworks/base/core/java/android/webkit/WebSettings.java 中 定义 ， 有 具体 的 定义 原型 如 下 。 


Tr 


public abstract void setMixedContentMode(int mode); 
public abstract int getMixedContentMode(); 
public static final int MIXED CONTENT ALWAYS ALLOW = 0; 
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public static final int MIXED CONTENT NEVER ALLOW = 1; 
public static final int MIXED CONTENT COMPATIBILITY MODE = 2; 


DÉI setMixedContentMode 和 getMixedContentMode 在 文件 AwSettings.java 中 定义 , 具体 
实现 代码 如 下 。 


public void setMixedContentMode(int mode) { 
synchronized (mAwSettingsLock) { 
if (mMixedContentMode != mode) { 
mMixedContentMode = mode; 
mEventHandler.update WebkitPreferences Locked(); 


} 
public int getMixedContentMode() { 


synchronized (mAwSettingsLock) { 
return mMixedContentMode; 


1.3.8 引入 第 三 方 (00kie 

在 Android 5.0 的 WebView 系统 中 ， 将 通过 函数 setAcceptThirdPartyCookies 和 
acceptThirdPartyCookies 在 网 页 中 引入 第 三 方 Cookie. P BI setAcceptThirdPartyCookies 和 
acceptThirdPartyCookies E X f T- platform/frameworks/base/core/java/android/webkit/CookieManager.java 
中 定义 ， 具 体 定义 原型 如 下 。 


protected Object clone() throws CloneNotSupportedException { 

throw new CloneNotSupportedException("doesn't implement Cloneable"); 
j 

public static synchronized CookieManager getInstance() { 

return WebViewFactory.getProvider().getCookieManager(); 

j 

public synchronized void setAcceptCookie(boolean accept) { 

throw new MustOverrideException(); 

j 

public synchronized boolean acceptCookie() { 

throw new MustOverrideException(); 

j 

public void setAcceptThirdPartyCookies(WebView webview, boolean accept) { 
throw new MustOverrideException(); 

j 

public boolean acceptThirdPartyCookies(WebView webview) { 

throw new MustOverrideException(); 


j 


public void setCookie(String url, String value) { 
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throw new MustOverrideException(); 
} 
public void setCookie(String url, String value, ValueCallback<Boolean> callback) { 
throw new MustOverrideException(); 
} 
public String getCookie(String url) { 
throw new MustOverrideException(); 
} 
public String getCookie(String url, boolean privateBrowsing) { 
throw new MustOverrideException(); 
} 
public synchronized String getCookie(WebAddress uri) { 
throw new MustOverrideException(); 
} 
public void removeSessionCookie() { 
throw new MustOverrideException(); 
} 
public void removeSessionCookies(ValueCallback<Boolean> callback) { 
throw new MustOverrideException(); 
} 
@Deprecated 
public void removeAllICookie() { 
throw new MustOverrideException(); 
} 
public void removeAllCookies(ValueCallback«Boolean- callback) { 
throw new MustOverrideException(); 
} 
public synchronized boolean hasCookies() { 
throw new MustOverrideException(); 
} 
public synchronized boolean hasCookies(boolean privateBrowsing) { 
throw new MustOverrideException(); 
} 
@Deprecated 
public void removeExpiredCookie() { 
throw new MustOverrideException(); 
} 
public void flush() { 
flushCookieStore(); 
} 
protected void flushCookieStore() { 
} 
public static boolean allowFileSchemeCookies() { 
return getInstance().allowFileSchemeCookiesImpl(); 


j 


protected boolean allowFileSchemeCookiesImpl() { 
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throw new MustOverrideException(); 


j 


// Static for backward compatibility. 


public static void setAcceptFileSchemeCookies(boolean accept) { 


getInstance().setAcceptFileSchemeCookiesImpl(accept); 


j 


protected void setAcceptFileSchemeCookiesImpl(boolean accept) { 


throw new MustOverrideException(); 


j 


1.2.9 实战 演练 一 一 在 手机 屏幕 中 浏览 网 页 


在 Android 系统 中 ， 可 以 使 用 内 


ELEY) WebKit 引擎 中 的 WebView 迅速 浏览 网 页 。 在 本 实 


例 中 ， 通 过 WebView.loadUrl 来 加 载 网 址 。 所 以 从 EditText 传 入 要 浏览 的 网 址 后 ， 就 可 以 在 


WebView 中 加 载 网 页 的 内 容 了 。 


题 H W 源码 路 径 
实例 7-2 在 手机 屏幕 中 浏览 网 页 daima\7\wang 


本 实例 的 具体 实现 流程 如 下 。 


(1) 编写 布局 文件 main ml, 4EM 


ZE 


<!-- 建立 一 个 TextView --> 
<TextView 


android:id="@-+id/myTextView1" 


android:layout_width="fill_parent" 


android:layout height-"wrap content" 


android:text="@string/hello" 


[^ 
<!-- 建立 一 个 EditText --> 
<EditText 


android:id="@+id/myEditText1" 
android: layout width-"267px" 


android:layout_height="40px" 
android:textSize="18sp" 
android:layout_x="5px" 
android: layout_y="32px" 

[^ 


<!-- 建立 一 个 ImageButton --> 


<ImageButton 


android:id="(@+id/myImageButton1" 


ERI 


android:layout width: 


wrap content" 


android:layout height-"wrap content" 
android:background-" (g)drawable/white" 


android:src-"(g)drawable/go" 
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android:layout x-"275px" 
android:layout_y="35px" 


j= 
<!-- 建立 一 个 WebView --> 
<WebView 


android:id="@+id/my WebView 1" 
android:layout_height="330px" 
android:layout_width="300px" 

android: layout_x="7px" 
android:layout_y="90px" 

android: background="(@drawable/black" 
android: focusable="false" 

[^ 


(2) 编写 文件 wang.java， 通 过 setOnClickListener 监听 按钮 单 击 事件 ， 单 击 网 址 后 面 的 箭 
头 后 会 抓 取 EditText 中 的 数据 ， 然 后 打开 此 网 址 ， 并 在 WebView 中 显示 网 页 内 容 。 具 体 实现 
代码 如 下 。 


package irdc.wang; 
import irdc.wang.R; 
import android.app.Activity; 
import android.os.Bundle; 
import android.view.KeyEvent; 
import android.view. View; 
import android. webkit.Web View; 
import android.widget.EditText; 
import android.widget.ImageButton; 
import android.widget. Toast; 
public void onCreate(Bundle savedInstanceState) 
1 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
mimageButton! = (ImageButton)find ViewByld(R.id.myImageButton1); 
mEditText1 = (EditText)findViewById(R.id.myEditText1); 
mWebViewl = (WebView) findViewByld(R.id.myWebView1); 
(rr RE SJ 
mlmageButtonl .setOnClickListener(new ImageButton.OnClickListener() 
1 
@Override 
public void onClick(View arg0) 
1 


mlimageButtonl.setImageResource(R.drawable.go 2); 
/* 抓 取 EditText 中 的 数据 */ 

String strURI = (mEditText1.getText().toString()); 

IS WebView 显示 网 页 内 容 */ 
mWebView1.loadUrl(strURD; 
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Toast.makeText( 


DE 


执行 上 述 代码 后 


a 


KZ 


example2.this, getString(R.string.load)+strURI, 
Toast.LENGTH LONG) 
.show(); 


显示 一 个 文本 框 , 在 文本 框 中 可 以 输入 一 个 网 页 地 址 , 当 单 击 后 面 的 ， 


按钮 后 会 显示 此 网 页 的 内 容 。 例 如 输入 http:/www.sohu.com 后 的 效果 如 图 7-5 所 示 。 
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图 7-5 来 到 搜狐 网 主页 


BECGEEHEE SJ EIN ARATE, 5) Web JJ H 


Sof MSE 
第 8 对 开发 移动 网 页 


发 将 成 为 现 阶 段 一 个 部 


匠 兴 的 热点 ， 所 以 开 


发 能 在 Android 手机 上 浏览 的 网 页 是 很 有 必要 的 。 本 书 前面 所 讲解 的 HTML、CSS、JavaScript 
技术 都 是 网 页 开发 技术 ， 用 这 三 种 技术 开发 的 网 页 能 够 在 手机 屏幕 上 正常 浏览 吗 ? 答案 是 肯 
但 是 前 提 是 需要 进行 一 些 变动 。 在 本 章 的 内 容 中 ， 将 详细 讲解 为 Android 系统 开发 移 
动 网 页 的 基本 知识 。 


定 的 ， 


8.] 


第 一 段 Android 网 页 代码 


接 下 来 将 以 一 个 具体 的 例子 作为 开始 , 本 实例 使 用 HTML 和 CSS 技术 实现 了 4 个 简单 的 


网 页 


开发 。 


实 d$ Xj fë 源码 路 径 
实例 8-1 编写 一 个 适用 于 Android 系统 的 网 页 daima\8\first\ 
81.1 编写 HIME 文件 
让 中 主页 文件 index.html 的 源 代码 如 下 。 
<html> 
<head> 
<title>aaa</title> 
<link rel="stylesheet" href="desktop.css" type="text/css" /> 
<body> 


<div id="container"> 
<div id="header"> 
<hl ><a href="/">AAAA</a></h1> 
<div id="utility"> 
<ul> 
<li><a href="about.html">3¢+ FR }</a></li> 
<li><a href="blog.html">{#%</a></li> 
<li><a href="contact.html">] A 3] ]</a></li> 
</ul> 
</div> 
<div id="nav"> 
<ul> 
<li><a href="bbb.html">Android Z 3%</a></li> 
<li><a hre 人 "ccc.html"> 电 话 支 持 </a></] 这 
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希望 事实 如 此 .…</p> 


<li><a hre 全 "ddd.html"> 在 线 客服 </a></i> 
<li><a hre 人 "http:/www.aaa.com'"> 在 线 视频 </a></i> 
</ul> 
</div> 
</div> 
<div id="content"> 
<h2>About</h2> 
<p> 欢 迎 大 家 学 习 Android, ALE AARE ERA, 我 也 是 这 么 认为 的 ， 


</div> 
«div id="sidebar"> 
<img alt=" 好 图 片 " src="aaa.png"> 
<p> 欢 迎 大 家 学 习 Android， 都 说 这 是 一 个 前 途 辉 煌 的 职业 ， 我 也 这 么 认为 的 ， 


希望 事实 如 此 .…</p> 
</div> 
<div id="footer"> 
<ul> 
<li><a href="bbb.html">Services</a></li> 
<li><a href="ccc.html">A bout</a></li> 
<li><a href="ddd.html">Blog</a></li> 
</ul> 
<p class-"subtle' II F </p> 
</div> 
</div> 
</body> 


</html> 


饰 上 述 网 页 的 样式 。 


恨 据 “样式 和 表现 相 分 离 ” 的 原则 ， 需 要 单独 写 一 个 CSS 文件 ， 通 过 这 个 CSS 文件 来 修 


注意 : 在 现实 的 应 用 开发 中 ， 最 好 将 桌面 浏览 器 的 样式 表 和 Android 样式 表 划 清 界限 。 


编者 建议 编写 两 个 完全 


独立 的 文件 。 当 然 还 有 另 一 种 做 法 是 把 所 有 的 CSS 规则 放 到 一 个 单一 


的 样式 表 中 ， 但 是 这 种 做 法 的 缺点 如 下 。 


Cb 文件 太 长 了 就 显得 麻烦 ， 不 利于 维护 。 


D 把 太 多 不 相关 的 桌面 样式 规则 发 送 到 手机 上 ， 会 浪费 网 络 带宽 和 存储 空间 。 
8.1.2 ”编写 OS sc 


开始 编写 CSS 文件 ， 为 了 适应 Android 系统 ， 编 写 下 面 的 link 标签 。 


<link rel="stylesheet" type="text/css" 

href="android.css" media="only screen and (max-width: 480px)" /> 
<link rel="stylesheet" type="text/css" 

href="desktop.css" media="screen and (min-width: 481 px)" /> 


在 上 述 代码 中 ， 最 明显 的 变动 是 浏览 器 宽度 的 变化 ， 即 ; 


max-width: 480px 
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min-width: 481px 
这 是 因为 手机 屏幕 和 计算 机 屏幕 的 宽度 是 不 一 样 的 〈 当 然 长 度 也 不 一 样 ， 但 是 都 
有 下 拉 功 能 )，480 像素 是 Android 系统 的 标准 宽度 ， 上 述 代码 的 功能 是 不 管 浏览 器 的 窗 
口 是 多 大 ， 桌 面 用 户 看 到 的 都 是 文件 desktop.css 中 样式 修饰 的 页 面 ， 宽 度 都 是 用 如 下 的 
代码 来 设置 的 。 


max-width: 480px 
min-width: 48 1px 


im 


在 本 实例 中 有 如 下 两 个 CSS 文件 。 

D) 文件 desktop.css: 在 开发 计算 机 页 面 时 编写 的 样式 文件 ， 是 为 HTML 页 面 服务 的 。 

口 文件 Android.css: 是 一 个 新 文件 ， 通 过 这 个 文件 可 以 将 网 页 显示 在 Android 手机 中 。 
当 开 发 者 开发 出 完整 的 Android.css 文件 后 ， 可 以 直接 在 HTML 文件 中 将 如 下 代码 删 
除 ， 即 不 再 用 这 段 代 码 修饰 文件 了 。 


<link rel="stylesheet" type="text/css" 
href="desktop.css" media="screen and (min-width: 48 1px)" /> 


此 时 用 浏览 器 打开 修改 后 的 HTML 文件 ， 无 论 从 Android 手机 浏览 是 计算 
机 桌面 浏览 器 中 打开 ， 执 行 后 都 将 得 到 一 个 完整 的 页 面 展示 。 此 时 的 完整 代码 如 d 
<html> 
<head> 

<title>AAAA</title> 

<link rel="stylesheet" type="text/css" href="android.css" media="only screen and (max-width: 
480px)" /> 

<link rel="stylesheet" type="text/css" href="desktop.css" media="screen and (min-width: 
481px)" /> 

<!--[if IE]> 

<link rel="stylesheet" type="text/css" href="explorer.css" media="all" /> 
<![endif]--> 


<script type="text/javascript" src="jquery.js"></script> 
<script type="text/javascript" src="android.js"></script> 
<meta http-equiv-"Content-Type" content="text/html; charset=gb2312"> 
</head> 
<body> 
<div id="container"> 
«div id="header"> 
<h1><a href="./">AAAA</a></h1> 
«div id="utility"> 
<ul> 
<li><a href="about.html">X T Fel ]</a></li> 
<li><a href="blog.html">#%</a></li> 
<li><a href-"contact.html" HX SS Hel }</a></li> 
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</ul> 
</div> 
<div id="nav"> 
<ul> 
<li><a href="bbb.html">Android 之 家 </a></li> 
<li><a hre 人 "ccc.html"> 电 话 支 持 </a></]i> 
<li><a hre 伟 "ddd.html"> 在 线 客 服 </a></li> 
<li><a hre 伍 "http:/www.aaa.com"> 在 线 视频 </a></li> 
</ul> 
</div> 
</div> 
<div id="content"> 
<h2>About</h2> 
<p> 欢 迎 大 家 学 习 Android, MBL MAE, 我 也 是 这 么 认为 的 ， 


希望 事实 如 此 .…</p> 
</div> 


<div id="sidebar"> 


<img alt=" E] Fr" src="aaa.png"> 
<p> 欢 迎 大 家 学 习 Android, AUX PASM AME, 我 也 是 这 么 认为 的 ， 


希望 事实 如 此 .…</p> 


</div> 
<div id="footer"> 
<ul> 
<li><a href="bbb.html">Services</a></li> 
<li><a href="ccc.html">About</a></li> 
<li><a href="ddd.html">Blog</a></li> 
</ul> 
«p class="subtle"> Aj gi </p> 
</div> 
</div> 
</body> 
</html> 
</html> 


而 文件 desktop.css 的 代码 如 下 。 


For example: 
body { 
margin:0; 
padding:0; 
font: 75% "Lucida Grande", "Trebuchet MS", Verdana, sans-serif; 


} 
执行 效果 如 图 8-1 所 示 。 
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欢迎 大 家 学 习 Android ， 都 说 这 是 一 个 前 途 辉 熔 的 职业 ， 我 也 是 这 么 认为 的 , 


e Services 

e About 

* Blo 
ale mn 


图 8-1 执行 效果 


8.1.3 ”控制 页 面 的 缩放 


希望 事实 如 此 …. 
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除非 明确 告知 Android 浏览 器 ， 否则 它 会 认为 页 面 宽 度 是 980px。 当 然 这 在 大 多 数 情况 下 
能 工作 得 很 好 ， 因 为 计算 机 已 经 适应 了 这 个 宽度 。 但 是 如 果 和 针对 小 尺寸 屏幕 的 Android FHL, 
则 必须 做 一 些 调整 ， 必 须 在 HTML 文件 的 head 元 素 中 添加 viewport 的 元 标签 ， 确 保 移动 浏 


览 器 获取 屏幕 的 大 小 ， 代 码 如 下 。 


<meta name="Viewport" content="user-scalable=no, width=device-width" /> 


这 样 就 实现 了 屏幕 的 自动 缩放 功能 ， 可 以 根据 屏幕 的 大 小 显示 大 小 不 


司 的 页 面 。 无 须 担 


心 加 上 viewport 元 标签 后 在 计算 机 上 的 显示 效果 ， 因 为 桌面 浏览 器 会 忽略 wiewport 元 标签 。 


如 果 不 设置 viewport 的 宽度 ， 页 面 在 加 载 后 会 缩小 。 缩 放 后 


置 过 viewport 宽度 ， 这 个 设置 项 也 会 影响 页 面 的 缩放 大 小 。 


8.2 为 Android 中 的 网 页 添加 CSS 样式 


接着 上 一 节 的 演示 代码 继续 讲解 ， 开 始 编写 样式 文件 android. 


页 在 Android 手机 上 完整 并 优美 地 显示 。 


8.24 编写 基本 的 样式 
这 里 的 基本 样式 是 指 诸如 背景 颜色 、 字 体 大 小 、 字 体 颜 色 等 术 


的 大 小 是 不 确定 的 ， 因 为 
Android 浏览 器 的 设置 项 允许 用 户 设置 默认 的 缩放 大 小 ， 选 项 有 大 、 中 《默认 )、 小 。 即 使 设 


css， 此 文件 的 功能 是 使 网 


LF 式 。 接 下 来 以 上 一 节 


实例 为 基础 进行 功能 扩展 ， 具 体 实现 流程 如 下 。 


PI 
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(1) 在 文件 android.css 4 


body { 


设置 <body> 元 素 的 如 下 基本 样式 。 


background-color: #ddd; /* Sts r */ 
color: #222; [* 字体 颜色 */ 
font-family: Helvetica; [* 字体 */ 
font-size: 14px; [* 字体 大 小 */ 
margin: 0; [* 外 边 距 */ 
padding: 0; [* 内 边 距 */ 
j 
(2) 开始 处 理 <header> 中 的 <div> 内 容 ， 包 含 主要 入 口 的 链接 〈 也 就 是 logo) 和 一 级 、 二 
级 站 点 导航 。 第 一 步 是 把 logo 链接 的 格式 调整 为 可 以 点 击 的 标题 栏 ， 将 下 面 的 代码 加 入 到 文 


件 android.css 中 。 


#header h1 { 
margin: 0; 
padding: 0; 

} 

#header hl a { 


background-color: #ccc; 


border-bottom: 1px 
color: #222; 
display: block; 
font-size: 20px; 
font-weight: bold; 
padding: 10px 0; 
text-align: center; 


, 


solid #666 


text-decoration: none; 


j 


(3) 


同样 的 方式 格式 化 一 级 和 二 级 导航 的 <ul> 元 素 。 在 此 只 需 月 


昌 通 用 的 标签 选择 器 (也 


就 是 #beader ul〉 即 可 ， 而 不 必 


QO) #header ul. 

QO) #utility. 

QO) #header ul. 

QO) #nav. 
实现 此 过 程 的 代码 如 下 。 


#header ul { 
list-style: none; 
margin: 10px; 
padding: 0; 

j 

#header ul li a ( 


204 BH 


下 设置 标签 <ID>， 也 就 不 必 设 置 如 下 的 样式 。 


第 8 章 开发 移动 网 页 1 


background-color: #FFFFFF; 
border: 1px solid #999999; 
color: #222222; 

display: block; 

font-size: 17px; 

font-weight: bold; 
margin-bottom: -1px; 
padding: 12px 10px; 
text-decoration: none; 


j 


(4) X content 和 sidebar div 添加 点 内 边 距 ， 在 文字 和 屏幕 边缘 之 间 空 出 一 定 距 离 。 有 具体 
代码 如 下 。 


#content, #sidebar { 
padding: 10px; 
j 


(5) 接 下 来 设置 <footer> 中 内 容 的 样式 ，<footer> 里 面 的 内 容 比较 简单 ， 只 需 将 display ix 
‘aA none 即 可 。 有 具体 代码 如 下 。 


#footer { 
display: none; 
} 


上 述 代码 在 计算 机 中 执行 的 效果 如 图 8-2 所 示 。 


About 


欢迎 大 家 学 习 Android ,都 说 这 是 一 个 前 途 辉 党 的 职业 ， 我 也 是 这 么 认为 的 ， 希 望 事实 如 此 .… 


欢迎 大 家 学 习 Android， 都 说 这 是 一 个 前 途 辉 深 的 职业 ， 我 也 是 这 么 认为 的 ， 希 望 事实 如 此 .… 
* Services 
* About 
* Blo 

lS 


图 8-2 计算 机 中 的 执行 效果 
在 Android 模拟 器 中 的 执行 效果 如 图 8-3 所 示 。 
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因为 添加 了 自动 缩放 ， 
8.2.2 ”添加 视觉 效果 


| 在 线 客服 


在 线 视 频 


Menu 


About 


欢迎 大 家 学 习 Android， 都 说 这 是 一 个 前 途 辉 煌 
的 职业 ， 我 也 是 这 么 认为 的 ， 希 望 事 实 如 此 …. 


欢迎 大 家 学 习 Android， 都 说 这 是 一 个 前 途 辉 煌 
的 职业 ， 我 也 是 这 么 认为 的 ， 希 望 事 实 如 此 …. 


图 8-3 在 Android 模拟 器 中 的 执行 效果 


并 且 添 加 了 修饰 Menu 的 样式 ， 所 以 整个 界面 很 协调 。 


为 了 使 页 面 变 得 更 加 精彩 ， 可 以 尝试 加 一 些 充满 视觉 效果 的 样式 。 


(1) 给 <header> 文 字 加 lpx 向 下 的 白色 阴影 ， 背 景 加 上 CSS 渐变 效果 。 有 具体 代码 如 下 。 


#header hl a { 


text-shadow: Opx 1px | px #fff; 


background-image: -webkit-gradient(linear, left top, left bottom, from(#ccc), to(#999)); 


j 


对 于 上 述 代 码 有 两 点 说 明 。 


Q text-shadow: 参数 从 左 到 右 分 别 表 示 水 平 偏 移 、 垂 直 偏 移 、 GE 在 大 多 
数 情况 下 ， 可 以 将 文字 设置 成 上 面 代码 中 的 数值 。 在 大 部 分 浏览 器 上 ， 将 模糊 范围 设 


EC 


置 为 0px 也 能 看 到 效果 。 但 Andorid 要 求 模糊 范围 最 少 是 Ipx， SE 0px， 则 在 


Android 设备 上 将 显示 不 出 文字 阴影 。 
口 -webkit-gradient: 功能 是 让 浏览 器 在 运行 时 产生 一 张 渐变 的 图 片 。 因 此 , 可 以 把 CSS 


渐变 功能 用 在 任何 指定 图 片 〈 比 如 背景 图 片 或 者 列表 式 图 片 ) URL 的 地 方 。 参 数 


从 左 到 右 的 排列 顺 
以 是 left top. left bottom. right top 或 者 right bottom)、 渐 变 终点 、 起 点 颜色 、 终 


点 颜色 。 


DA ol Ji 


是 : 渐变 类 型 (可 以 是 linear 或 者 radial)、 渐 变 起 点 (可 


在 此 需要 注意 ， 在 上 述 赋值 中 不 能 颠倒 描述 渐变 起 点 、 终 点 常量 〈left top. left bottom, 


right top. right bottom ) 的 水 平 


是 不 合法 的 值 。 


“和 垂直 顺序 。 也 就 是 说 top left. bottom left, top right 和 bottom right 


(2) 给 导航 菜单 加 上 圆 角 样式 ， 代 人 码 如 下 。 
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#header ul li:first-child a { 
-webkit-border-top-left-radius: 8px; 
-webkit-border-top-right-radius: 8px; 
} 
#header ul li:last-child a { 
-webkit-border-bottom-left-radius: 8px; 
-webkit-border-bottom-right-radius: 8px; 
} 
在 上 述 代码 中 ， 使 用 属性 “-webkit-border- radius” 描 述 角 的 方式 ， 定 义 了 列表 中 第 一 个 
元 素 的 上 两 个 角 和 最 后 一 个 元 素 的 下 两 个 角 为 以 8 像素 为 半径 的 圆 角 。 此 时 在 Android 模拟 
器 中 的 执行 效果 如 图 8-4 所 示 。 


关于 我 们 


博客 
联系 我 们 


Android 之 家 

电话 支持 

在 线 客服 

在 线 视频 
Menu 


图 8-4 在 Android 中 的 执行 效果 


此 时 会 发 现 列表 显示 样式 变 为 了 圆 角 样式 ， 整 个 外 观 显 得 更 加 圆滑 和 上 自然 。 


8.3 为 Android 网 页 添加 JavaScript 特效 


经 过 前 面 的 步骤 ， 一 个 基本 的 HTML 页 面 就 设计 完成 了 ， 并 且 这 人 -1 aa de Android 
手机 上 完美 显示 。 为 了 使 页 面 更 加 完美 ， 在 接 下 来 的 内 容 中 ， 将 详细 讲解 在 上 述 页 面 中 添加 
JavaScript 行为 特效 的 基本 知识 。 


8.3.1 jQuery 框架 介绍 

jQuery 是 继 prototype 之 后 又 一 个 优秀 的 JavaScript 框架 。jQuery 是 一 个 轻 量 级 的 JS PE, 
压缩 后 只 有 21kB 的 大 小 。jQuery 不 但 兼容 CSS3， 而 且 还 兼容 各 种 浏览 器 。jQuery 不 但 使 用 
户 可 以 更 方便 地 处 理 HTML Documents. Events 和 动画 元 素 , 并 且 方 便 地 为 网 站 提供 Ajax (FE 
JavaScript 和 XML ) 交互 。jQuery 能 够 使 用 户 的 HIML 页 面 保持 代码 和 内 容 相 分 离 ， 即 不 
用 在 HTML 里 面 插入 一 堆 Js 来 调用 命令 ， 只 需 定 义 ID 即 可 。 
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1. 语法 


jQuery 是 为 HTML 元 素 的 选取 编制 的 ， 通 过 jQuery 可 以 对 HTML 元 素 执 行 某 些 操 作 。 
使 用 jQuery 的 基础 语法 格式 如 下 。 


$(selector).action() 


O 美元 符号 : 定义 jQuery。 


C) 选择 符 (selector): 


“AW” MAR” HTML 元 素 。 


口 action): 执行 对 元 素 的 操作 动作 。 


例如 下 面 的 代码 。 


$(this).hide() II ES 4 RU TORE 
$("p").hide() /隐藏 所 有 段落 
$("p.test").hide() /隐藏 所 有 class="test" 的 段落 
$("#test").hide() /隐藏 所 有 id="test" 的 元 素 
.简单 实用 
下 代码 来 认识 jQuery 的 强大 功能 
<html> 
<head> 


<script type="text/javascript" src="/jquery/jquery.js"></script> 


<script type="text/javascript"> 
$(document).ready(function() { 


$("button") 


click(function() { 


$("#test").hide(); 


Ob 
II 
</script> 
</head> 


<body> 
<h2>This is a 
<p>This is a p: 


heading</h2> 
aragraph.</p> 


<p id="test">This is another paragraph.</p> 
<button type="button">Click me</button> 


</body> 
</html> 


上 述 代 码 演示 了 
效果 如 图 8-5 所 示 ， 
个 按钮 ， 此 时 页 面 一 
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jQuery 中 函数 hide0 的 基本 用 法 ， 功 能 是 隐藏 当前 的 HTML 元 素 。 执 行 


只 显示 一 个 按钮 。 
片 空白 。 


单 击 这 个 按钮 后 ， 会 隐藏 所 有 的 HTML 元 素 ， 包 括 这 


Click me | 


图 8-5 未 被 隐藏 时 


u 第 8 章 开发 移动 网 页 人 


注意 : 本 书 的 重点 不 是 jQuery， 所 以 不 再 对 其 使 用 知识 进行 讲解 。 读 者 可 以 参阅 其 他 书 
籍 或 网 上 教程 来 学 习 。 


8.3.2 ”使 网 页 支持 动态 行为 


本 小 节 继 续 以 前 面 的 实例 8-1 为 基础 ， 下 面 的 步骤 是 给 页 面 添加 一 些 JavaScript 元 素 , 使 
页 面 支 持 一 些 基本 的 动态 行为 。 在 具体 实现 的 时 候 ， 使 用 了 前 面 介绍 的 jQuery 框架 。 本 实例 
的 目的 是 ， 让 用 户 控制 是 否 显示 页 面 顶 部 的 导航 栏 。 实 现 上 述 功能 的 具体 流程 如 下 。 

(1) 隐藏 <header> 中 的 元素 ， 它 在 用 户 第 一 次 加 载 页 面 后 就 不 会 显示 。 具体 代码 如 下 。 


#header ul. hide{ 
display: none; 
) 


(2) 定义 显示 和 隐藏 菜单 的 按钮 ， 有 具体 代码 如 下 。 


\ 


<div class=” leftButton” onclick= “toggleMenu() “>Menu< / div> 


定义 一 个 带 有 leftButton 类 的 div 元 素 ， 然 后 将 其 放 在 header 里 面 。 下 面 是 完整 CSS FF 
式 的 代码 。 


#header div.leftButton { 
position: absolute; 


top: 7px; 

left: 6px; 

height: 30px; 

font-weight: bold; 

text-align: center; 

color: white; 

text-shadow: rgba (0,0,0,0.6) Opx -1px 1px; 

line-height: 28px; 

border-width: 0 8px 0 8px; 

-webkit-border-image: url(images/button.png) 0 8 0 8; 
} 


上 述 代码 的 具体 说 明 如 下 。 

口 “position: absolute": 从 顶部 开始 ， 设 置 position 为 absolute， 相 当 于 把 这 个 div 元 素 
从 HTML 文件 流 中 去 掉 ， 从 而 可 以 设置 自己 的 最 上 面 和 最 左面 的 坐标 。 

O “height: 30px”: 设置 高 度 为 30px。 

QO “font-weight: bold”: 定义 文字 格式 为 粗 体 ， 白 色 带 有 一 点 问 下 的 阴影 ， 在 元 素 里 居中 
显示 。 

O “text-shadow: rgba”: rgb(255, 255，255)、rgb(100%，100%，10096) 格 式 和 #EFFFFF 
格式 是 一 个 原理 , 都 是 设置 颜色 值 的 。 在 rgba0 函 数 中 , 它 的 第 4 个 参数 用 来 定义 alpha 
值 〈 透 明度 )， 取 值 范 围 从 0 到 1。 其 中 0 表示 完全 透明 ，1 表示 完全 不 透明 ， 0 到 1 
之 间 的 小 数 表示 不 同 程 度 的 半 透 明 。 


L 
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line-height: 控制 元 素 中 的 文字 向 下 移动 的 距离 ， 使 之 不 会 与 上 边框 齐 平 。 

O border-width 和 -webkit-border-image: 这 两 个 属性 一 起 决定 把 一 张 图 片 的 一 部 分 放 入 某 
一 元 素 的 边框 中 去 。 如 果 元 素 大 小 由 于 文字 的 增 减 而 改变 ， 图 片 会 自动 拉 伸 适应 这 样 
的 变化 。 这 一 点 意味 着 只 需要 不 多 的 图 片 、 少 量 的 工作 、 低 带宽 和 更 少 的 加 载 时 间 。 

O border-width: 让 浏览 器 把 元 素 的 边框 定位 在 距 上 0px, IEA 8px、 距 下 0px, IEA 8px 
的 地 方 〈4 个 参数 从 上 开始 ， 以 顺 时 针 方 向 为 顺序 )， 不 需要 指定 边框 的 颜色 和 样式 。 
定义 好 边框 宽度 之 后 ， 就 可 以 确定 放 进 去 的 图 片 了 。 

口 url(images/button.png) 0 8 0 8: 5 个 参数 从 左 到 右 分 别 是 图 片 的 URL、 上 边 距 、 右边 距 、 
下 边 距 、 左 边 距 (再 一 次 ， 从 上 上 且 顺 时 针 开 始 )。URL 可 以 是 绝对 路 径 或 者 相对 路 径 ， 

后 者 是 相对 于 样式 表 所 在 的 位 置 ， 而 不 是 引用 样式 表 的 HTML 页 面 的 位 置 

(3) 在 HTML 文件 中 插入 JavaScript 的 代码 ， 将 对 aaa.js 和 bbb.js 的 引用 写 到 HTML 文 
件 中 。 


A 


口 | 


<script type="text/javascript" src="aaa.js"></script> 
<script type="text/javascript" src="bbb.js"></script> 


文件 bbbjjs 的 主要 作用 是 让 用 户 显示 或 者 隐藏 nav 菜单 ， 具 体 代码 如 下 。 


if (window.innerWidth && window.innerWidth <= 480) { 
$(document).ready(function() { 
$(‘#header ul').addClass(‘hide’); 
$(‘#header').append(‘<div class="leftButton" onclick="toggleMenu()">Menu</div>'); 


function toggleMenu() { 
S( header ul').toggleClass(‘hide'); 


1 

2 

3 

4 

5 Ir 
6 

7 

8 $(‘#header .leftButton').toggleClass('pressed"); 
9 


} 
10 } 


对 上 述 代码 的 具体 说 明 如 下 。 
第 1 行 : 括号 中 的 代码 ， 表 示 当 window 对 象 的 innerWidth 属性 存在 并 且 innerWidth 小 
于 等 于 480px (这 是 大 部 分 手机 合理 的 最 大 宽度 值 ) 时 才 执行 函数 内 部 。 这 一 行 保证 只 有 当 用 
户 用 Android 手机 或 者 类 似 屏 幕 大 小 的 设备 访问 这 个 页 面 时 ， 才 会 执行 上 述 代 人 三。 

第 2 行 : 使 用 函数 document ready， 此 函数 是 “网 页 加 载 完 成 ”函数 。 这 段 代码 的 功能 是 
当 网 页 加 载 完 成 之 后 才 运 行 里 面 的 代码 。 


第 3 行 : 使 用 了 典型 的 jQuery 代码 ,目的 是 选择 header 中 的 ul 元 素 并 且 往 其 中 添加 hide 
类 。 此 处 的 hide 内 容 是 前 面 CSS 文件 中 的 选择 器 ， 这 行 代码 的 执行 效果 是 隐藏 header 的 ul 
元 素 


447: 为 header 添加 按钮 ， 目 的 是 可 以 “显示 /隐藏 ”菜单 。 

7 行 : 在 函数 toggleMenu0 中 , 用 jQuery 的 toggleClass() 函 数 添 加 或 删除 所 选择 对 和 象 中 
的 某 个 类 。 这 里 应 用 了 header DI ul 里 的 hide 类 。 

8 fT: TE header 的 leftButton 里 添加 或 删除 pressed 类 ， 类 pressed 的 具体 代码 如 下 。 


M 
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#header div.pressed { 
-webkit-border-image: url(images/button_clicked.png) 0 8 0 8; 


j 


通过 上 述 样式 和 JavaScript 行为 设置 之 后 ，Menu 会 默认 隐藏 链接 内 容 ， 单 击 之 后 才 会 在 
下 方 显示 链接 信息 ， 如 图 8-6 所 示 。 


| 关于 我 们 


m 


村 


IX} 


| 
| 联系 我 们 


| Android 之 家 


电话 支持 


| 在 线 客服 


| 在 线 视频 
Menu 


About 


欢迎 大 家 学 习 Android ， 都 说 这 是 一 个 前 途 辉 煌 
的 职业 ， 我 也 是 这 么 认为 的 ， 希 望 事实 如 此 ,… … 


图 8-6 下 方 显示 信息 


8.4 ZC Android 网 页 中 使 用 Ajax 特效 


Ajax 是 指 异步 JavaScript 和 XML 技术 , 是 Asynchronous JavaScript and XML 的 缩写 。Ajax 
不 是 一 种 新 的 编程 语言 ， 而 是 一 种 用 于 创建 更 好 、 更 快 以 及 交互 性 更 强 的 Web 应 用 程序 的 
技术 。 通 过 使 用 Ajax 和 JavaScript， 可 以 将 XMLHttpRequest 对 象 直接 与 服务 器 进行 通信 。 通 
过 这 个 对 象 ，JavaScript 可 以 在 不 重 载 页 面 的 情况 下 与 Web 服务 器 进行 数据 交换 。Ajax 在 浏 
Vas Web 服务 器 之 间 使 用 异步 数据 传输 (HTTP 请 求 )， 这 样 就 可 以 使 网 页 从 服务 器 中 请 
求 少量 的 信息 ， 而 不 是 整个 页 面 。 

在 本 节 的 内 容 中 ， 将 详细 讲解 在 Android 系统 中 为 网 页 添加 Ajax 特效 的 基本 知识 。 

在 接 下 来 的 内 容 中 ,将 通过 一 个 具体 实例 来 讲解 在 Android 网 页 中 使 用 Ajax 技术 的 过 程 。 


Ko fl 功 能 源码 路 径 
实例 8-2 在 Android 系统 中 开发 一 个 Ajax 网 页 daima\8\gaoii\ 


(1) 编写 一 个 名 为 android.html 的 HTML 文件 ， 具 体 代 码 如 下 。 


<html> 
<head> 


<title>Jonathan Stark</title> 
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«meta name-'"viewport" content="user-scalable=no, width=device-width" /> 
<link rel="stylesheet" href="android.css" type="text/css" media="screen" /> 
="jquery.js" ></script> 


<script type="text/javascript" src 
<script type="text/javascript" src 

</head> 

<body> 
«div id="header"><h1>AAA</h1></div> 
<div id="container"></div> 

</body> 

</html> 


android.js"></script> 


(2) 编写 样式 文件 android.css， 主 要 代码 如 下 。 
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body { 
background-color: #ddd; 
color: #222; 
font-family: Helvetica; 
font-size: 14px; 
margin: 0; 
padding: 0; 

} 

#header { 
background-color: #ccc; 
background-image: -webkit-gradient(linear, left top, left bottom, from(#ccc), to(#999)); 
border-color: #666; 
border-style: solid; 
border-width: 0 0 1px 0; 

} 

#header hl { 
color: #222; 
font-size: 20px; 
font-weight: bold; 
margin: 0 auto; 
padding: 10px 0; 
text-align: center; 
text-shadow: Opx 1px 1px #fff; 
max-width: 160px; 
overflow: hidden; 
white-space: nowrap; 
text-overflow: ellipsis; 

} 

ul { 
list-style: none; 
margin: 10px; 
padding: 0; 

} 

ul lia { 


background-color: #FFF; 
border: 1px solid #999; 
color: #222; 
display: block; 


font-size: 17px; 
font-weight: bold; 


margin-bottom: -1px; 


padding: 12px 10px; 


text-decoration: none; 


} 


ul li:first-child a { 
-webkit-border-top-left-radius: 8px; 


-webkit-border-top-right-radius: 8px; 


j 


ul li:last-child a { 
-webkit-border-bottom-left-radius: 8px; 


-webkit-border-bottom-right-radius: 8px; 


j 


ul li a:active, ul li a:hover { 


background-color: blue; 


color: white; 


j 


#content { 


padding: 10px; 


text-shadow: Opx 1px 1px #fff; 


j 


#content a { 


color: blue; 


j 


(3) 继续 编写 如 下 HTML 文件 。 


about.html. 
blog.html. 


consulting-clinic.html - 


index.html. 


口 
口 
DQ contact.html. 
口 
口 


为 了 简单 起 见 ， 上 述 文件 的 实现 代码 都 是 一 样 的 ， 
<html> 
<head> 
<title>AAA</title> 
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UAI. 


«meta name-'"viewport" content="user-scalable=no, width=device-width" /> 


<link rel="stylesheet" type="text/css" href="android.css" media="only screen and (max-width: 


480px)" /> 


<link rel="stylesheet" type="text/css" href="desktop.css" media="screen and (min-width: 


481px)" /> 
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<!--[if IE]> 
<link rel="stylesheet" type="text/css" href="explorer.css" media="all" /> 
<![endif]--> 


<script type="text/javascript" src="jquery .js"></script> 


<script type="text/javascript" src="android.js"></script> 
<meta http-equiv="Content-Type" content="text/html; charset=gb2312"> 
</head> 
<body> 
<div id="container"> 
<div id="header"> 
<h1><a href="/">AAAA</a></h1> 
«div id="utility"> 
<ul> 
<li><a href="about.html">AAA</a></li> 
<li><a href="blog.html">BBB</a></li> 
<li><a href="contact.html">CCC</a></li> 
</ul> 
</div> 
<div id="nav"> 
<ul> 
<li><a href="bbb.html">DDD</a></li> 
<li><a href="ccc. html" >EEE</a></li> 
<li><a href="ddd.html">FFF</a></li> 
<li><a href="http://www.aaa.com">GGG</a></li> 
</ul> 
</div> 
</div> 
<div id="content"> 
<h2>About</h2> 
<p> 欢 迎 大 家 学 习 Android, MBL MAE, 我 也 是 这 么 认为 的 ， 


希望 事实 如 此 .…</p> 
</div> 
<div id="sidebar"> 
<img alt=" 好 图 片 " sro="aaa.png"> 
<p> 欢 迎 大 家 学 习 Android, 都 说 这 是 一 个 前 途 辉 煌 的 职业 , 我 也 是 这 么 认为 的 ， 


希望 事实 如 此 ....</p> 
</div> 
<div id="footer"> 
<ul> 
<li><a href="bbb.html">Services</a></li> 
<li><a href="ccc.html">A bout</a></li> 
<li><a href="ddd.html">Blog</a></li> 


</ul> 
<p class-"subtle"- Jii UE ti Bir 
</div> 


</div> 
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如 下 。 
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</body> 
</html> 
(4) 编写 JavaScript 文件 android.js， 在 此 文件 中 使 用 了 Ajax 技术 。 具 体 实现 代码 
1 var hist = []; 
2 var startUrl ='index.html'; 
3 $(document).ready(function() { 
4 loadPage(startUrl); 
3 E 
6 function loadPage(url) { 
7 $(‘body').append(‘<div id="progress">wait for a moment...</div>'); 
8 scrollTo(0,0); 
9 if (url == startUrl) { 
10 var element =' #header ul'; 
11 } else { 
12 var element = ' Zcontent'; 
13 } 
14 $(‘#container').load(url + element, function(){ 
15 var title = $(‘h2').html() || Ke"; 
16 $(‘h1').html(title); 
17 $(‘h2').remove(); 
18 $(‘.leftButton').remove(); 
19 hist.unshift( {"url':url, 'title':title}); 
20 if (hist.length > 1) { 
21 $(‘#header’).append(‘<div class="leftButton">'thist[1 ].title+'</div>'); 
p» $(‘#header.leftButton').click(function(e) ( 
2/5) $(e.target).addClass('clicked"); 
24 var thisPage — hist.shift(); 
25 var previousPage = hist.shift(); 
26 loadPage(previousPage.url); 
27 Di 
28 } 
29 $('#container a').click(function(e) { 
30 var url = e.target.href; 
31 if (url.match(/aaa.com/)) { 
32 e.preventDefault(); 
33 loadPage(url); 
34 ) 
35 Di 
36 $(‘#progress').remove(); 
37 » 


38 3 


对 于 上 述 代码 的 具体 说 明 如 下 。 
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O 第 1~5 行 : 使 用 了 jQuery 的 document.ready 函数 ， 目 的 是 使 浏览 器 在 加 载 页 面 完 成 
ciis 1T loadPage() EK Zt 
O 剩余 的 行 数 是 函数 loadPage(ur]) 部 分 ， 此 函数 的 功能 是 载 入 地 址 为 URL 的 网 页 , 但 是 
在 载 入 时 使 用 了 Ajax 技术 特效 。 具 体 说 明 如 下 。 

e 第 7 行 : 为 了 使 Ajax 效果 能 够 显示 出 来 ， 在 loadPage0) 函 数 启动 时 ， 在 body 中 增加 
一 个 正在 加 载 的 div。 

e 第 9 一 13 行 : 如 果 没 有 在 调用 函数 的 时 候 指定 url PA document ready 函数 
中 调用 ), url 将 会 是 undefined， 这 一 行 会 被 执行 。 第 9 行 和 第 10 行 是 jQuery 的 load() 
函数 样 例 。load0 函 数 在 为 页 面 增加 简单 快速 的 特效 上 非常 出 色 。 如 果 把 这 一 行 
翻译 出 来 ， 它 的 意思 是 “从 index.html 4X tH Prfi£header 中 的 ul 元 素 ， 并 把 它们 插 
入 到 当前 页 面 的 #container LRP”. “4 url 参数 有 值 的 时 候 ， 执 行 第 12 行 。 从 效果 上 
看 是 :“ 从 传 给 loadPage0 函 数 的 url 中 得 到 #content 元 素 ， 并 把 它们 插入 当前 页 面 的 
#container 元 素 中 ”。 

(5) 最 后 的 修饰 

为 了 能 使 设计 的 页 面体 现 出 Ajax 效果 ， 还 需要 继续 设置 样式 文件 android.css. 

口 为 了 能 够 显示 出 “加 载 中 ...” 的 样式 ， 需 要 在 文件 android.css 中 添加 如 下 对 应 的 修饰 
代码 。 


T 


2 


#progress { 
-webkit-border-radius: 1 0px; 
background-color: rgba(0,0,0,.7); 
color: white; 
font-size: 18px; 
font-weight: bold; 
height: 80px; 
left: 60px; 
line-height: 80px; 
margin: 0 auto; 
position: absolute; 
text-align: center; 
top: 120px; 
width: 200px; 

} 


O 用 边框 图 片 修饰 返回 按钮 ， 并 清除 默认 的 点 击 后 高 亮 显示 的 效果 。 在 文件 android.css 
中 添加 如 下 的 修饰 代码 。 
#header div.leftButton { 


font-weight: bold; 
text-align: center; 


line-height: 28px; 
color: white; 
text-shadow: Opx -1px 1px rgba(0,0,0,0.6); 
position: absolute; 
216 EE 


top: 7px; 

left: 6px; 

max-width: 50px; 
white-space: nowrap; 
overflow: hidden; 
text-overflow: ellipsis; 
border-width: 0 8px 0 14px; 
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-webkit-border-image: url(images/back button.png) 0 8 0 14; 


-webkit-tap-highlight-color: rgba(0,0,0,0); 
} 


在 Android 中 执行 上 述 文件 ， 在 加 载 时 会 显示 “wait for a moment...” 的 提示 ， 如 图 


所 示 。 在 滑动 选择 某 个 链接 的 时 候 ， 被 选中 的 按钮 会 显示 不 同 的 颜色 ， 如 图 8-8 所 示 。 


AAA 


GGG 


图 8-8 被 选择 的 不 同 颜色 


AAAA 
AAA 
BBB 
DDD 
EEE 
FFF | 
GGG 
图 8-7 提示 特效 
而 文件 android.html 的 执行 效果 和 其 他 文 伯 
hel 
AAA 
BBB 
ccc 
DDD 
EEE 
FFF 
GGG 
图 8-9 3x 


F 相 比 略 有 不 同 ， 如 图 8-9 所 示 。 


lo! 


F android.html 的 执行 效果 


8.5 ”使 用 第 三 万 框架 实现 动画 效果 


除了 可 以 为 Android 网 页 添加 Ajax 特效 


之 外 ， 还 可 以 为 其 添加 动画 效果 ， 这 样 可 以 让 
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充满 活力 。 在 本 节 的 内 容 中 ， 将 详细 讲解 为 Android 网 页 添加 动画 效果 的 基 


Android 网 页 更 加 
本 知识 。 


854 ”一 个 开源 框架 一 一 JIouch 


JQTouch JI 


t 了 具有 一 系列 功能 的 jQuery 插件 ,这 些 功能 可 以 为 手机 浏览 器 WebKit 服务 。 


JQTouch 使 构建 基于 Android Fl iOS 的 DOE, 只 需要 开发 人 员 掌 握 少量 的 HTML、 
CSS 和 JavaScript 知识 ， 就 能 够 创建 可 在 WebKit 浏览 器 上 GOS. Android. Palm Pre) 运行 


的 手机 应 用 程序 。 


读者 可 以 在 JQTouch 的 官方 地 址 http://www.jqtouch.com 中 下 载 资源 , JQTouch 完 


下 载 后 可 以 直接 使 用 。 


8.5.2 一 个 简单 应 用 


完全 开源 ， 


接 下 来 将 通过 一 个 具体 实例 的 实现 过 程 ， 详 细 讲 解 使 用 JQTouch 框架 为 Android 网 页 实 


现 动画 效果 的 过 程 。 
实 例 H 的 源码 路 径 
在 id 系统 中 使 
实 人 在 Android 系统 中 使 用 JQTouch daima\8\donghua\ 


框架 开发 网 页 


ny 
M 


编写 一 个 名 为 index.html 的 HTML 文件 ， 有 具体 代码 如 下 。 


<!DOCTYPE html> 


<html> 


<head> 


<title>AAA</title> 


<link type="text/css" rel="stylesheet" media="screen" href="jqtouch/jqtouch.css"> 
<link type="text/css" rel="stylesheet" media="screen" href="themes/jqt/theme.css"> 


<script type="text/javascript" src="jqtouch/jquery.js"></script> 
<script type="text/javascript" src="jqtouch/jqtouch.js"></script> 
<script type="text/javascript"> 
var jQT = $.jQTouch({ 
icon: 'kilo.png' 
Ir 


</script> 


</head> 
<body> 
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<div id="home"> 
<div class="toolbar"> 
<h1>Data</h1> 
<a class="button flip" href="#settings">Settings</a> 
</div> 
<ul class="edgetoedge"> 
<li class="arrow"><a href="#dates">Dates</a></li> 
<li class="arrow"><a href="#about">A bout</a></li> 
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</ul> 
</div> 
<div id="about"> 
«div class="toolbar"> 
<h1>About</h1> 
<a class="button back" href="#">Back</a> 
</div> 
<div> 
<p>Choose you food.</p> 
</div> 
</div> 
<div id="dates"> 
«div class="toolbar"> 


<h1>Time</h1> 
<a class="button back" href="#">Back</a> 
</div> 


<ul class="edgetoedge"> 
<li class="arrow"><a id="0" href="#date">AAA</a></li> 
<li class="arrow"><a id="1" href="#date">BBB</a></li> 
<li class="arrow"><a id="2" href="#date">CCC</a></li> 
<li class="arrow"><a id="3" href="#date">DDD</a></li> 
<li class="arrow"><a id="4" href="#date">EEE</a></li> 
<li class="arrow"><a id="5" href="#date">FFF</a></li> 
</ul> 
</div> 
<div id="date"> 
<div class="toolbar"> 
<h1>Time</h1> 
<a class="button back" href="#">Back</a> 
<a class="button slideup" href="#createEntry">+</a> 
</div> 
<ul class="edgetoedge"> 
<li id="entryTemplate" class="entry" style="display:none"> 
<span class="label">Label</span> <span class="calories">000</span> <span 
class="delete">Delete</span> 
</li> 
</ul> 
</div> 
<div id="createEntry"> 
<div class="toolbar"> 
<hl>WHY</h1> 
<a class="button cancel" href="#">Cancel</a> 
</div> 


<form method="post"> 
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<ul class="rounded"> 
<li><input type="text" placeholder="Food" ^ name-"food" id="food" 
autocapitalize="off" autocorrect="off" autocomplete="off" /></li> 
<li><input type="text" placeholder-"Calories" name="calories" id="calories" 
autocapitalize="off" autocorrect="off" autocomplete="off" /></li> 
<li><input type="submit" class="submit" name="waction" value="Save Entry" /></li> 
</ul> 
</form> 
</div> 
<div id="settings"> 
<div class="toolbar"> 
<h1>Control</h1> 
<a class="button cancel" href="#">Cancel</a> 
</div> 
<form method="post"> 
<ul class="rounded"> 
<li><input placeholder="Age" type="text" name="age" id="age" /></li> 
<li><input placeholder="Weight" type="text" name-"weight" id="Weight" /></li> 
<li><input placeholder="Budget" type="text" name="budget" id="budget" /></li> 


<li><input type="submit" class="submit" name-"waction" value-"Save 
Changes" /></li> 


</ul> 
</form> 
</div> 
</body> 
</html> 


接 下 来 开始 对 上 述 代码 进行 详细 讲解 。 
CD 通过 如 下 代码 启用 JQTouch Fil jQuery. 


<script type="text/javascript" src="jqtouch/jquery.js"></script> 
<script type="text/javascript" src="jqtouch/jqtouch.js"></script> 


(2) 实现 home 面板， 具体 代码 如 下 。 


<div id="home"> 


<div class="toolbar"> 


<h1>Data</h1> 
<a class="button flip" href="#settings">Settings</a> 
</div> 


<ul class="edgetoedge"> 
<li class="arrow"><a href="#dates">Dates</a></li> 
<li class="arrow"><a href="#about">A bout</a></li> 
</ul> 
</div> 
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对 应 的 效果 如 图 8-10 所 示 。 


Settings 


面板 


图 8-10 home 


(3) 实现 about 面板 ， 有 具体 代码 如 下 。 


«div id="about"> 
<div class="toolbar"> 
<h1>About</h1> 
<a class="button back" href="#">Back</a> 
</div> 
<div> 
<p>Choose you food.</p> 
</div> 
</div> 


对 应 的 效果 如 图 8-11 所 示 。 


Settings 


图 8-11 about 面板 
(4) 实现 dates 面板 ， 具 体 代码 如 下 。 


«div id="dates"> 
<div class="toolbar"> 
<h1>Time</h1> 
<a class="button back" href="#">Back</a> 
</div> 
<ul class="edgetoedge"> 
<li class="arrow"><a id="0" href="#date">AAA</a></li> 
<li class="arrow"><a id="1" href="#date">BBB</a></li> 
<li class="arrow"><a id="2" href="#date">CCC</a></li> 
<li class="arrow"><a id="3" href="#date">DDD</a></li> 
<li class="arrow"><a id="4" href="#date">EEE</a></li> 
<li class="arrow"><a id="5" href="#date">FFF</a></li> 
</ul> 
</div> 
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对 应 的 效果 如 图 8-12 所 示 。 


图 8-12 dates 面板 


(5) 实现 date 面板 ， 有 具体 代码 如 下 。 


<div id="date"> 
<div class="toolbar"> 


<h1>Time</h1> 
<a class="button back" href="#">Back</a> 
<a class="button slideup" href="#createEntry">+</a> 


</div> 


<ul class="edgetoedge"> 


<li id="entryTemplate" class="entry" style="display:none"> 
<span class="label">Label</span> «span class="calories">000</span> <span class= 


"delete">Delete</span> 


</li> 


</ul> 


</div> 


(6) 实现 settings 面板 ， 具 体 代 码 如 下 。 


<div id="settings"> 
<div class="toolbar"> 


<h1>Control</h1> 
<a class="button cancel" href="#">Cancel</a> 


</div> 


<form method="post"> 


<ul class="rounded"> 
<li><input placeholder="A ge" type="text" name="age" id="age" /></li> 
<li><input placeholder="Weight" type="text" name-"weight" id-"weight" /></li> 
<li><input placeholder="Budget" type="text" name="budget" id="budget" /></li> 
<li><input type="submit" class="submit" name-"waction" value="Save Changes" /></li> 
</ul> 


</form> 


</div> 
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对 应 的 效果 如 图 8-13 所 示 。 


Control 


Age 


Weight 


Budget 


图 8-13 settings 面板 
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接 下 来 看 样式 文件 theme.css, 此 样式 文件 非 


Sim, H 
主要 代码 如 下 。 
body { 
background: #000; 
color: #ddd; 
} 
#jqt>* { 


"m 


DÉ 


和 上， 功能 是 对 index.html 4 


background: -webkit-gradient(linear, 0% 0%, 0% 100%, from(#333), to(#5e5e65)); 


} 

#qt h1, #jqt h2 { 
font: bold 18px "Helvetica Neue", Helvetica; 
text-shadow: rgba(255,255,255,.2) 0 1px 1px 
color: #000; 
margin: 10px 20px 5px; 

} 

/* @group Toolbar */ 

#jqt .toolbar { 
-webkit-box-sizing: border-box; 
border-bottom: 1px solid #000; 
padding: 10px; 
height: 45px; 


a 


background: url(img/toolbar.png) #000000 repeat-x; 


position: relative; 


#jqt .black-translucent .toolbar { 
margin-top: 20px; 


#jqt toolbar > h1 { 
position: absolute; 
overflow: hidden; 


FP 的 元 素 进行 


实 图 8-10、 图 8-11、 图 8-12 和 图 8-13 都 是 经 过 theme.css 修饰 之 后 的 显示 效果 。 
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left: 50%; 
top: 10px; 
line-height: lem; 
margin: 1px 0 0 -75px; 
height: 40px; 
font-size: 20px; 
width: 150px; 
font-weight: bold; 
text-shadow: rgba(0,0,0,1) 0 -1px 1px; 
text-align: center; 
text-overflow: ellipsis; 
white-space: nowrap; 
color: #fff; 

j 

#jqt.landscape .toolbar > h1 1 
margin-left: -125px; 
width: 250px; 


#jqt button, #jqt back, #jqt .cancel, #jqt .add { 
position: absolute; 
overflow: hidden; 
top: 8px; 
right: 10px; 
margin: 0; 
border-width: 0 Spx; 
padding: 0 3px; 
width: auto; 
height: 30px; 
line-height: 30px; 
font-family: inherit; 
font-size: 12px; 
font-weight: bold; 
color: #fff; 
text-shadow: rgba(0, 0, 0, 0.5) Opx -1px 0; 
text-overflow: ellipsis; 
text-decoration: none; 
white-space: nowrap; 
background: none; 
-webkit-border-image: url(img/button.png) 0 5 0 5; 


#jqt .button.active, #jqt .cancel.active, #jqt .add.active { 
-webkit-border-image: url(img/button clicked.png) 0 5 0 5; 


color: #aaa; 


#jqt .blueButton { 
-webkit-border-image: url(img/blueButton.png) 0 5 0 5; 


224 NH 


第 8 章 开发 移动 网 页 


border-width: 0 Spx; 


} 

#jqt .back { 
left: 6px; 
right: auto; 
padding: 0; 
max-width: 55px; 
border-width: 0 8px 0 14px; 
-webkit-border-image: url(img/back_button.png) 0 8 0 14; 

} 

#jqt .back.active { 
-webkit-border-image: url(img/back_button_clicked.png) 0 8 0 14; 

} 

#jqt .leftButton, #jqt .cancel { 
left: 6px; 
right: auto; 

} 

#jqt .add { 
font-size: 24px; 
line-height: 24px; 
font-weight: bold; 

} 

#jqt .whiteButton, 

#jqt .gray Button, #jqt .redButton, #jqt .blueButton, #jqt .greenButton { 
display: block; 
border-width: 0 12px; 
padding: 10px; 
text-align: center; 
font-size: 20px; 
font-weight: bold; 
text-decoration: inherit; 
color: inherit; 

j 


#jqt .whiteButton.active, #jqt .grayButton.active, #jqt .redButton.active, #jqt .blueButton.active, 


#jqt .greenButton.active, 


#jqt .whiteButton:active, #jqt .grayButton:active, #jqt .redButton:active, #jqt .blueButton:active, 


#jqt .greenButton:active { 


j 


-webkit-border-image: url(img/activeButton.png) 0 12 0 12; 


#jqt .whiteButton 1 


} 


-webkit-border-image: url(img/whiteButton.png) 0 12 0 12; 
text-shadow: rgba(255, 255, 255, 0.7) 0 1px 0; 


#jqt .grayButton { 


-webkit-border-image: url(img/grayButton.png) 0 12 0 12; 
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color: #FFFFFF; 
} 
到 此 为 止 ， 整 个 实例 全 部 讲解 完毕 ， 此 时 每 一 个 页 面 的 切换 功能 都 具有 了 动画 效果 ， 如 
图 8-14 所 示 。 
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图 8-14 ”闪烁 的 动画 效果 
因为 图 片 体现 不 出 动画 效果 ， 所 以 建议 读者 在 模拟 器 上 亲自 实践 体验 。 


8.6 ”为 网 页 增加 数据 存储 功能 


大 多 数 应 用 程序 都 需要 某 种 持久 化 的 方式 来 存储 有 用 的 数据 。 对 于 网 络 应 用 程序 来 说 ， 
这 个 任务 一 般 会 交 给 服务 器 端的 数据 库 或 者 在 浏览 器 中 的 Cookie 来 完成 。 伴 随 着 HTML 5 的 
EI, Web 开发 者 有 了 另外 两 种 选择 : Web Storage 和 Web SQL Database。 在 本 节 的 内 容 中 
将 详细 讲解 为 Android 网 页 增加 数据 存储 功能 的 方法 。 


8.6.1 Æ Android 网 页 中 使 用 Web Storage 


Web Storage 有 两 种 形式 ， 分 别 是 localStorage〈 本 地 存储 ) 和 sessionStorage【〈 会 话 存储 )。 
这 两 种 形式 都 允许 开发 者 使 用 JavaScript 设置 “ 键 值 对 ”， 并 在 重新 加 载 不 同 页 面 的 时 候 读 出 
里 面 的 数据 。 这 点 和 Cookie 机 制 非常 类 似 。 但 是 和 Cookie 不 同 的 是 ，Web Storage 的 数据 是 
完全 存储 在 客户 端的 ,无须 通过 浏览 器 请 求 再 传输 到 服务 器 。 由 此 可 见 ， 和 Cookie 方式 相 比 ， 
Web Storage 可 以 在 本 地 存储 更 多 的 数据 。 

localStorage 和 sessionStorage 在 功能 上 是 一 样 的 ， 只 是 在 持久 性 和 范围 上 有 所 不 同 。 

(1) tocalStorage 

即使 已 经 关闭 了 浏览 窗口 ， 数 据 也 会 被 保存 起 来 并 可 用 于 所 有 来 自 同 源 《必须 有 相同 的 
域名 、 协 议和 端口 ) 窗口 〈 或 者 标签 页 ) 的 加 载 ， 这 对 于 参数 设置 或 是 偏好 设置 之 类 的 功能 
非常 有 用 。 

(2) sessionStorage 

数据 存储 在 窗口 对 象 中 ， 对 于 其 他 窗口 或 者 标签 页 来 说 不 可 见 ， 并 且 当 窗口 关闭 时 会 丢 
失 数 据 。sessionStorage 可 用 于 特殊 的 窗口 状态 ， 例 如 一 个 标签 页 的 高 亮 状 态 或 者 一 个 表格 的 
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排序 状态 。 在 现实 应 用 中 ，sessionStorage 都 可 以 用 localStorage 来 代替 。 但 是 在 关闭 窗口 或 者 


标签 页 时 ， 会 丢失 sessionStorage 存储 的 数据 。 
设置 参数 的 方法 非常 简单 ， 例 如 : 


localStorage.setItem('age'.40); 


访问 一 个 存储 的 数据 的 方法 也 非常 简单 ， 例 如 : 


var age-localStorage.getItem('age"); 


可 以 用 如 下 代码 删除 一 个 特定 的 键 值 对 。 


localStorage. removeltem(‘age'); 


或 者 用 如 下 代码 删除 所 有 的 键 值 对 。 


localStorage.clear(); 


假设 键 是 有 效 的 JavaScript token， 比 如 没有 空格 、 没 有 除 下 画 线 之 外 的 标点 ， 则 可 以 使 


用 如 下 的 代码 实现 。 


localStorage.age=4e /设置 age 的 值 
var age=localStorage.age; /取得 age 的 值 
delete localStorage.age; /从 存储 中 删除 age 


键 名 ， 也 是 没有 冲突 的 。 


在 下 面 的 内 容 中 ， 将 举例 说 明 将 用 户 设置 
SessionStorage 中 的 方法 。 
1. 将 用 户 设置 保存 到 本 地 


保存 3 


站 本 地 和 将 选 吕 


接 下 来 介绍 一 个 实际 的 例子 , 目的 是 更 新 本 章 前 面 例子 
巴 表单 数据 存储 到 localStorage 当中 。 接 下 来 会 有 相当 数量 的 JavaScript 代码 ， 但 是 并 不 准备 
把 它们 都 放 进 HTML 文件 的 head 标签 中 。 为 了 保持 代码 的 工整 性 ， 在 存放 HTML 文档 的 相 


eL 


HSE localStorage 和 sessionStorage 中 的 键 是 分 开 存 储 的 。 即 使 在 两 种 存储 中 使 用 同样 的 


的 数据 保存 到 


HEY) Settings 面板 , 此 时 可 以 让 它 


同 路 径 下 创建 一 个 名 为 123.js 的 文件 ， 同 时 更 新 HTML 文件 中 的 head 部 分 来 引用 123.js。 


<head> 

<title>123< / title> 

<link type="text/css" rel="stylesheet" media="screen" 
href=”jqtouch/jqtouch.css‘“> 

<link type="text/css" rel="stylesheet" media="screen" 
href="themes/jqt/theme.css"> 


<script type="text/javasc ript" src=” "jqtouch/jquery.js">< / script> 


«script type="text/javasc ript" src="jqtouch/jqtouch.js">< / script> 


<script type="text/javascript" src="123.js"< / script> 
</head> 


由 此 可 见 , 在 更 新 的 同时 也 从 HTML 的 head 部 分 删除 了 jQTouch 的 构造 函数 。 其 实 它 3 
2 


a 
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没有 被 删除 ， 只 是 被 移 到 文件 123js Po 但 是 需要 确保 从 HTML 的 head 部 分 中 删除 上 述 提 到 
的 内 容 ， 并 且 在 相同 路 径 下 建立 如 下 内 容 的 123.js 文件 ， 然 后 在 浏览 器 中 刷新 主 HTML 文件 
以 确保 它 仍 旧 可 以 工作 。 


zm 


var jQT=$.jQTouch({ 
icon:' 123.png* 
DE 


代码 经 过 重新 组 织 以 后 ， 接 下 来 就 可 以 添加 保存 设置 代码 。 需 要 重 写 settings 表单 的 提交 
ie 并 用 一 个 名 为 saveSettingsO 的 自 定 义 函 数 来 替换 。 因 为 用 到 了 jQTouch， 所 以 只 
要 修改 Document Ready 函数 中 如 下 的 一 行 代码 ， 即 将 下 面 的 代码 加 入 到 123.js 中 。 


n 


$(document).ready(function() { 
$(‘#settings form") .submit(saveSettings); 


这 段 代码 的 作用 是 ， 当 用 户 提交 settings 表单 时 ， 用 saveSettings0 函 数 代替 表单 的 提交 动 
作 。 当 调用 saveSettings0 函 数 时 ， 会 用 jQTouch 的 val0 函 数 获得 表单 的 3 个 输入 项 ， 并 且 分 
别 存 入 localSto rage 这 个 同名 变量 中 。 将 函数 加 入 123 js 中 的 代码 如 下 。 


function saveSettings() 1 
localStorage.age=$(‘#age').val(); 
localStorage.budget=$(‘#budget’).val(); 
localStorage.weight=$(‘#weight').val.(); 
jQT.goBack(); 
return false; 


} 


日 数值 被 保存 ， 便 调用 jQTouch 的 goBack( PA AOR IFA rom, Bi 
来 返回 false 给 触发 这 个 函数 的 提交 事件 ， 以 防 进行 默认 的 提交 操作 。 如 果 没 有 这 行 代码 ， 现 
有 页 面 会 被 重新 加 载 一 次 。 
到 此 为 止 已 经 可 以 运行 程序 , 前 往 Settings 面板 输入 设置 信息 , 然后 提交 表单 将 设置 存储 
到 localStorage 中 。 由 于 在 提交 表单 时 没有 清空 相关 字段 ， 所 以 当 用 户 再 次 访问 Settings 面板 
时 ， 仍 然 会 存在 上 次 输入 的 数据 。 然 而 这 不 是 因为 使 用 了 localStorage 保存 的 缘故 ， 而 是 因为 
只 要 在 输入 后 不 进行 清理 操作 ， 这 些 字段 就 会 一 直 在 那里 。 因 此 ， 当 用 户 下 次 重新 运行 程序 
并 访问 Settings 面板 时 ， 即 使 这 些 字 段 被 保存 了 也 仍 会 丢失 。 

为 了 解决 这 个 问题 ， 需 要 使 用 函数 loadSettings0 来 加 载 配置 ， 所 以 在 文件 123.js 中 添加 
如 下 函数 。 


= 


function loadSettings) { 
$(‘#age').val(localStorage.age); 
$(‘#budget').val(localStorage. budget); 
$(‘#weight').val(localStorage. weight); 
) 


函数 loadSettings0 正 好 和 函数 saveSettings0 相 反 , 它 使 用 local Storage 中 的 相应 字段 来 调 
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用 jQTouch 的 函数 val0， 目 的 是 设置 Settings 表单 中 的 3 个 字段 值 。 
接 下 来 需要 触发 已 有 的 loadSettings0 函 数 ， 当 程序 启动 时 进行 触发 动作 。 为 了 实现 这 个 
功能 ， 在 文件 123.js 的 document ready 函数 中 添加 如 下 代码 。 


$(document).ready(function() { 
$(‘#settings form').submit(saveSettings); 
loadSettings(); 

p 


上 述 代码 只 是 在 程序 启动 时 加 载 配 置 , 这 样 会 存在 一 个 漏洞 :如 果 当 用 户 访问 Settings 
面板 并 改动 了 一 些 值 ， 然 后 单 击 Cancel 按钮 而 非 提 交 表 单 ， 程 序 下 次 就 不 能 加 载 正 确 的 
配置 。 在 这 种 情况 下 ， 当 用 户 再 次 访问 Settings 面板 时 会 显示 最 新 的 修改 。 这 不 是 因为 这 
些 新 的 数据 被 保存 了 《实际 上 并 没有 )， 而 只 是 界面 显示 的 问题 。 如 果 用 户 关 闭 并 重新 启 
动 程序 ， 显 示 的 数据 又 会 变 成 之 前 保存 的 数据 , 因为 函数 loadSettings0 会 在 程序 启动 的 时 
候 还 原 字段 中 的 数据 。 

其 实 有 很 多 方法 可 以 改变 这 种 情况 , 但 最 合适 的 方法 是 每 次 当 移 动 Settings 面板 时 , 无 论 
进入 还 是 退出 ， 都 需要 刷新 显示 的 数据 。 在 jQTouch 中 提供 了 一 种 简单 的 方法 将 函数 
loadSettingsO0 和 Settings 面板 的 pageAnimationStart 事件 绑 定 起 来 。 将 刚刚 加 入 的 代码 用 如 下 
加 粗 的 代码 来 代替 。 


=, 


$(document).ready(function() { 

$(‘#settings form').submit(saveSettings); 

$(‘#settings') .bind(‘pageAnimationStart' loadSettings); 
Di 


现在 文件 123.js 中 的 JavaScript 代码 为 Settings 面板 提供 了 持久 化 的 数据 存储 。 以 下 是 当 
前 文件 123 js 中 的 代码 。 


var jQT=$.jQTouch({ 
icon: '123.png' 
>); 
$(document).ready(function() { 
$(‘#settings form').submit(saveSettings); 
$(‘#settings').bind(‘pageAnimationStart',loadSettings); 

D; 

function loadSettings) 1 
$('#age').val(localStorage.age); 
$('#budget').val(localStorage.budget); 
$('#weight').val(localStorage.weight); 

) 

function saveSettings() 1 
localStorage.age=$(‘#age').val(); 
localStorage.budget=$(‘#budget').val(); 
localStorage. weight=$(‘#weight’).val(); 
jQT.goBack(); 
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return false: 


j 


2. 将 选中 的 数据 保存 到 Session Storage 中 


因为 希望 允许 用 户 在 数据 库 中 添加 或 者 删除 条 目 ， 所 以 需要 支持 Date 面板 上 提供 “+” 


按钮 和 Delete 按钮 。 在 具体 实现 时 ， 第 一 步 是 当 用 户 从 Dates 面板 访问 Date 面板 时 ， 需 要 让 
Date 面板 获知 用 户 单 击 的 是 哪个 条 目 。 有 了 这 个 信息 ， 就 可 以 计算 出 合适 的 日 期 的 上 下 文 语 


境 。 为 了 实现 这 个 功能 ， 需 要 在 文 们 


$(document).ready(function() { 
$(‘#settings form').submit(saveSettings); 
$(‘#settings').bind(‘pageAnimationStart',loadSettings); 


$(‘#dates li a').click(function() { AO) 
var dayOffset=this.id; //(2) 
var date=new Date(); //(3) 


date.setDate(date.getDate() - dayOffset); 
sessionStorage.currentDate=date.getHonth()+1+’/’+ 
date.getDate()+/'+ 


date.getFullY ear(); WEN 
refreshEntries(); WEN 
DE 
D 


F 123 js 的 函数 document reday 中 添加 如 下 的 代码 。 


(1) jQTouch 中 的 clickO 函 数 将 它 随 后 的 JavaScript 代码 和 Dates 面板 中 的 click 事件 的 链 
接 绑 定 起 来 。 
获取 被 单 击 对 象 的 ID， 并 且 将 其 存 入 dayOffset 变量 中 。Dates 面板 中 的 链接 都 有 从 


(2) 


0—5 范围 的 站， 所 以 被 点 击 的 链接 的 ID 就 相当 于 点 击 


0 天 表示 今天 ， 过 去 1 天 表示 上 昨天， 过 去 2 天 表示 前 天 ， 
创建 了 一 个 新 的 JavaScript 日 期 对 象 ， 并 且 将 其 存 入 一 个 名 为 date 的 变量 中 。 首 先 ， 
这 个 date 会 被 设置 成 创建 的 日 期 ,所 以 在 下 一 行 中 会 从 getDate0 函 数 的 结果 中 减 去 dayOffset， 
再 用 setDate0 函 数 将 日 期 设置 成 选中 的 日 期 。 其 中 dayOffset 为 0 表示 今天 ，1 表示 昨天 ， 依 


(3) 


此 类 推 。 


(5) 


Su. 


加 到 文人 


230 HH 


日 期 所 需要 计算 的 天 数 ， 比 如 ， 过 去 


依 此 类 推 。 


(4) 生成 了 一 个 “MM/DD/YYYY” 格 式 的 日 期 字符 串 ， 并 将 其 作为 当前 日 期 (currentDate) 
存 入 sessionStorage。 


123js 中 ， 具 体 代 码 如 下 。 


function refreshEntries() { 
var currentDate=sessionStorage.currentDate; 
$(‘#date  hl').text (currentDate); 
) 


调用 refreshEnt ries0 函 数 。 此 函数 的 作用 是 ， 基 于 用 户 单 击 Dates 面板 的 日 期 值 来 更 
新 Date 面板 。 现 在 只 要 使 用 用 户 选中 的 日 期 来 更 新 Dates 面板 工具 栏 上 的 标题 ， 就 能 看 到 它 
起 的 具体 作用 。 如 果 没 有 这 个 函数 ， 运 行 后 只 会 出 现 “Date” 字 样 。 函 数 refreshEntries s 
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8.6.2 c Android 网 页 中 使 用 Web SQL Database 


在 所 有 HTML 5 的 特性 中 ，Web SQL Database 的 功能 非常 强大 。Web SQL Database 提供 
给 开发 者 一 个 简单 而 强大 的 JavaScript 数据 库 API， 使 得 可 以 在 一 个 本 地 SQLite 数据 库 中 持 
久保 存 数 据 。 其 实 Web SQL Database 并 非 是 HTML 5 的 一 部 分 ， 它 其 实 是 摆脱 了 HTML 5 的 
细则 ， 并 将 其 融入 到 自己 的 细则 当中 。 

开发 者 可 以 使 用 标准 SQL 语句 来 创建 数据 表 及 插入 、 更 新 、 查 找 和 删除 行 。JavaScript 
Database API 其 至 能 够 支持 Transaction (31450. SQL 有 与 生 俱 来 的 复杂 性 ， 但 无 论 如 何 ， 这 
是 一 个 改变 游戏 规则 的 变化 ， 所 以 关注 它 本 身 可 能 会 更 有 意义 。 在 接 下 来 的 内 容 中 ， 将 详 纪 
讲解 使 用 Web SQL Database 操作 数据 库 的 基本 知识 。 

1. 创建 数据 库 

现在 用 户 已 经 选择 好 Date 面板 所 需 的 数据 了 ， 在 编写 createEntry0 函 数 之 前 ， 还 要 建立 
一 个 数据 库 来 存储 提交 的 数据 (这 是 个 一 次 性 的 操作 )。 可 以 在 文件 123.js 中 添加 如 下 代码 来 
实现 这 项 功能 。 


var db; /1/(1) 
$(dacument).ready(function() { 
$(‘#settings form") .submit (saveSettings); 
$(‘#settings').bind(‘pageAnimationSta rt’ loadSettings); 
$(‘#dates li a').click(functian() { 
var dayOffset=this.id; 
var date=new Date(); 
date.setDate(date.getDate() - dayOffset); 
sessionStorage.currentDate=date.getMonth()+1+’ /’+ 
date. getDate()+'/'+ 
date. getFullYear(); 


refreshEntries(); 
D: 
var shortName="123'; WEN 
var version='1.0'; 
var displayName='123'; 
var maxSize=65536; 
db=openDatabase(shortName, version,displayName,maxSize); //(3) 
db.transaction( WEN 
function(transaction) { WEN 
transaction.executeSql( /K(6) 
'CREATE TABLE IF NOT EXISTS entries + 
' (id INTEGER NOT NULL PRIMARY KEY AUTOINCREHENT, 十 
y date DATE NOT NULL, food TEXT NOT NULL, '+ 
'calories INTEGER NOT NULL); ' 
); 
} 
)s 
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d) GE 


这 个 变量 就 会 保存 连接 的 引用 。 


会 用 到 它 。 


(2) 接 下 来 的 4 行 代码 定义 了 调 
一 个 指向 硬盘 上 
口 version: 当 需 要 修改 数据 库 模 式 时 ， 用 来 管 到 

序 启动 时 检查 version 字段 ， 如 果 过 


口 shortName: 


E 意 的 是 ， 在 程序 


E 
H 


个 名 为 db 的 全 局 变量 。 


有 


数据 移 到 新 数据 库 中 。 


它 之 所 以 被 设置 成 全 


局 变量 ， 是 


A rb 
EH o 


的 数据 库 文件 的 字符 


二 期 则 创建 一 


口 displayName: 表 


L] maxSize: 


(3) 当 参 数 被 设置 


示 用 户 显 示 的 字符 串 。 
允许 数据 库 增长 到 的 最 大 KB 数 。 
以 后 ， 这 行 代码 将 


会 调用 openDatabase( ) 并 且 将 数据 


变量 中 。 如 果 数 据 库 不 存在 ， 则 会 新 建 一 个 。 
(4) 所 有 的 数据 库 查 询 都 必须 放 在 一 


升级 和 向 后 兼容 的 数字 。 例 如 ， 每 次 程 
个 新 的 数据 库 ， 并 且 将 老 数 据 库 中 的 


一 旦 建立 一 个 数据 库 连 接 ， 
因为 在 程序 的 各 个 地 方 都 将 


用 openDatabase( ) 需 要 的 参数 ， 具 体 说 明 如 下 。 


库 连接 存储 到 db 


个 事务 的 上 下 文 当中 ,所 以 这 里 i 


Ke 


F 


个 db WE 


H J 


的 transaction 方法 。 而 接 下 来 的 几 行 会 构造 一 个 函数 作为 唯一 的 参数 传 入 transaction 方法 。 


个 


(5) 从 本 行 


Ly EI 
HAE 


匿名 函数 ， 将 transaction 对 象 当 作 参数 传 入 。 


(6) 一旦 进入 这 个 函数 ， 调 用 transaction 对 象 的 executeSql0 方 法 来 执行 一 个 标准 的 


CREATE TABLE 查 ; 
再 次 创建 数据 表 的 


情形 。 


旬 语 句 。 


If] IF NOT EXISTS 子 句 ， 


能 够 防止 已 经 存在 数据 表 


的 情况 下 


如 果 再 次 启动 程序 , 会 在 Android 手机 上 创建 一 个 名 为 “123” 的 数据 库 。 在 Chrome 的 桌面 版 


HH, SEU 
Tools, it 
用 的 。 


示 上 是 可 


询 语句 。 
2. 插入 行 
现在 已 经 有 


函数 中 的 提交 事件 


绑 定 至 


以 浏览 并 操作 客户 端的 数据 库 的 ， 只 
后 点 击 Storage 选项 。 在 Chrome 桌面 版 
在 默认 情况 下 ， 这 个 工具 们 会 作为 浏览 器 的 一 个 面板 出 现 。 


显示 。 


个 配置 好 的 数据 库 来 接收 数据 条 
先 , 重 写 #createEntry 表单 的 提交 事件 , 通 
I 一 起 来 达成 此 目的 。 


[1 a= 已 
只 需要 导 


FH 
N 


如 


通过 点 击 数据 库 名 ， 这 个 界面 其 


目 ， 可 以 生成 一 个 createE 
过 将 createEntry ER BA CHE 123 js 4 


$(document).ready(function() { 

$ C'#createEntry form') .submit(createEntry); 
$(‘#settings form').submit(saveSettings); 
$(‘#settings').bind(‘pageAnimationStart',loadSettings); 


这 样 , 每 当 用 户 提 交 #createEntry 表单 时 就 会 


中 添加 如 下 的 代码 ， 以 在 数据 库 中 创建 记录 。 


function createEntryO ( 


var date=sessionStorage.currentDate; 


IO) 


var calories=$('#calories') .val(); 
var food=$(‘#food').val(); 
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点 击 浮动 
至 允许 执行 任 


调用 createEntry0) 函 数 。 接 下 来 , 在 文件 


航 到 View 一 Developer 一 Developer 
中 ，Developer Tools 对 于 调试 来 说 是 相当 有 


IS 


标 ， 这 个 
意 的 SQL d 


BS 
7 


ntry(0) 函 数 了 。 首 


H document ready 


下 面具 显示 了 前 几 行 ， 详 情 参见 粗 体 代码 。 


123.js 
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db.transaction( //(2) 
function(transaction) { 
transaction.executeSql( 
INSERT INTO entries (date, calories, food) VALUES(?,?,?);', 
[date, calories, food], 
functiont) { 
refreshEntries(); 
jQT. goBack(); 
» 
errorHandler 
); 
} 
); 
return false; 


) 


C1) 这 部 分 包含 了 将 会 在 SQL 查询 语句 中 使 用 的 一 些 变 量 。 前 面 用 户 在 Dates 面板 上 点 
击 的 日 期 数据 已 经 保存 在 sessionStorage.currentDate 中 ， 使 用 之 前 在 Settings 表单 中 用 到 的 相 
同方 法 ， 可 以 从 表单 中 获得 另外 两 个 值 (calories 和 food). 

(2) 这 段 代码 打开 一 个 数据 库 事务 ， 并 且 执 行 executeSql0 调 用 。 这 时 会 传 入 方法 
executeSql0 中 如 下 的 4 个 参数 。 

口 “INSERT INTO entries (date, calories, food) VALUES(?,?,?)”: 是 即将 被 执行 的 语句 ， 问 
号 代表 数据 占 位 符 。 

口 “[date,calories, food]": 这 个 数值 数组 将 被 传 入 数据 库 当 中 ， 和 SQL 语句 中 的 问号 占 
位 符 一 一 对 应 。 

O “function() {refreshEnt ries();iQT.goBack();}”: WR SQL 查询 语句 成 功 返 回 ， 这 个 匿 
名 函数 将 会 被 调用 。 
口 errorHandler: 如 果 执 行 SQL 语句 失败 ， 将 会 执行 错误 处 理 函 数 。 

假设 插入 数据 正确 ,将 会 执行 作为 第 3 个 参数 的 匿名 函数 。 这 个 函数 会 调用 refreshEnt ries() 
函数 。 现 在 这 个 函数 只 能 更 新 Date 面板 的 标题 ， 但 是 之 后 就 会 看 到 创建 的 条 目 在 列表 当 
中 显示 。 

如 果 插 入 不 成 功 则 会 执行 errorHandler() 函 数 。 在 文件 123.js 中 添加 如 下 代码 。 


function errorHandler(transaction, error){ 
alert('Oops. Error was'+error.message+' (Code'terror.code+')’): 
return true; 
) 


上 述 错误 处 理 函 数 会 传 入 两 个 参数 : transaction 对 象 和 error 对 象 。 这 里 使 用 error 对 象 来 
提示 用 户 错误 信息 和 抛 出 的 错误 码 。 错 误 处 理 函 数 必须 返回 true 或 false。 如 果 一 个 错误 处 理 
函数 返回 true， 比 如 这 是 一 个 致命 的 错误 ， 执 行 过 程 会 被 停止 并 且 整 个 事务 将 会 回 滚 ， 如 果 
错误 处 理 函 数 返 回 false， 比 如 这 不 是 一 个 致命 的 错误 ， 则 执行 过 程 会 继续 进行 。 

在 有 些 情况 下 , 可 能 需要 根据 不 同 的 错误 类 型 来 判断 返回 值 为 true 或 false。 其 实 除了 error 
BB 233 


TH 
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对 和 象 以 外 ,函数 errorHandler0) 接 收 了 一 个 transaction 对 象 ,如 果 没 有 建立 语句 当 ' 
表 的 话 ， 下 面 的 代码 将 不 会 被 执行 。 


function errorHandler(transaction, error){ 
alert('Oops. Error was'+error.message+' (Code'terror.code+-).); 
t ransaction.executeSql(INSERT INTO errors (code, message) VALUES(7,?);', 
[error.code,error.message]); 
return false; 


j 


如 果 希 望 执 行 executeSql0 函 数 中 的 语句 ， 那 么 错误 处 理 函 数 就 必须 返回 false. A0 H e 
HL), 则 在 包括 错误 处 理 在 内 的 整个 事务 当中 的 SQL 语句 都 将 会 回 滚 ， 


的 是 true( 或 者 没有 返 
这 样 就 达 不 到 希望 的 效果 了 。 
3. 检索 行 及 处 理 结果 集 


[n] 


接 下 来 需要 扩展 refreshEntries() PR UA s X 8 Be, 而 不 只 是 将 选择 的 E 


提 到 的 errors 


期 数据 更 新 到 


标签 栏 上 。 具 体 来 讲 ， 下 面 将 会 查询 数据 库 中 被 选择 的 日 期 条 目 ， 并 使 用 HTML 中 隐藏 的 


entryTemplate 把 它们 添加 到 #date ul 元 素 中 。 在 这 里 把 Date 面板 中 的 代码 再 次 展示 出 来 ， 它 


们 已 经 在 文件 index.html 中 了 ， 所 以 无 需 添 加 。 


<div id="date"> 

<div class="toolbar"> 

<hl>Date< / hl 

<a class="button back" href="#">Back</a> 

<a class="button slideup"href="#createEntry">+</a> 
</div> 

<ul class="edgetoedge"> 

<li id="ent ryTemplate" class=" entry "style="display:none"> 
<span class="label ">Label</span> 

<span class="calories ">OOO</span> 

<span class="delete">Delete</span> 

</li> 

</ul> 

</div> 


注意 上 面 的 加 粗 和 斜体 代码 : di 元 素 的 样式 属性 已 经 设置 成 “display:none”， 这 会 使 该 元 素 
不 在 页 面 上 显示 出 来 。 这 样 做 是 因为 使 用 了 HTML 代码 段 作为 数据 库 行 显示 的 模板 。 
下 面 是 完整 的 refreshEntriesO 函 数 ， 需 要 将 文件 123.js 中 现 有 的 函数 refreshEntries() 的 代 


V 


码 蔡 换 成 如 下 的 代码 。 


function refreshEntries() { 


var currentDate-sessionStorage.currentDate; /K(1) 
$(‘#date hl').text(currentDate); 

$(‘#date ul ti:gt(0) ').remove(); //(2) 
db.transaction( /K3) 


function(transaction) 1 
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transaction.executeSql( 
'SELECT A FROM entries WHERE date=7 ORDER BY food;’, 
{currentDate], 
function (transaction.result) { 
for (var i=0;i<result.rows.length; i++) { 
var row=result.rows.item(i); 
var newEntryRow=§(‘#ent ryTemplate").clone(); 
newEnt ryRow. removeAttr(‘id'); 
newEntryRaw.removeA ttr('style"); 
newEnt ryRow.data('entryId' row di: 
newEnt ryRow.appendTo(’#date ul"); 
newEnt ryRow.find('*label').text(row.food); 
newEnt ryRow.find(‘.calories').text(row.calories); 


} 
) 
errorHandler 
) 
je 
) 
); 


} 
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IMA) 
I5) 
WOH 


IT) 
IK8) 


IO) 
/K(10) 


(1) 使 用 sessionStorage 中 保存 的 currentDate 值 来 设置 Date 面板 中 的 标题 栏 。 
(2) 使 用 jQTouch 的 gt0 函 数 (gt 代表 “greater than”) 来 查找 并 移 除 任何 索引 大 于 0 的 


li 元 素 。 
(3) 这 3 行 用 于 设置 数据 库 事务 和 executeSql 语句 。 


(4) 本 行 包 含 了 executeSql 函数 的 第 一 个 参数 ， 这 是 一 个 简单 的 SELECT 语句 ， 问 号 代 


表 一 个 数据 占 位 符 。 


(5) 这 是 只 有 一 个 元 素 的 数组 ， 包 含 了 现 有 被 检索 到 的 数据 。 在 SQL 查询 语句 中 ， 问 号 


将 会 被 该 元 素 代替 。 


(6) 当 完 成 正确 的 查询 工作 时 会 调用 这 个 匿名 函数 ， 会 接收 到 两 个 参数 : transaction 和 


result. 


(7) 本 行使 用 rows 的 item() 方 法 把 查询 到 的 行 的 内 容 设置 到 row 变量 中 。 


T 


(8) 在 这 行 代码 中 , 使 用 clone() 方 法 来 复制 模板 li, 并 


现 有 多 个 相同 id 的 数据 项 。 
(9) 本 行 中 将 row 的 id 属性 作为 数据 存 入 i 元 素 
知道 这 是 哪 条 记录 。 


~ 


需要 这 个 数据 是 


旦 在 下 两 行 中 删除 掉 它 的 id 和 style 
属性 。 删 除 掉 style 属性 会 使 这 行 可 见 ， 而 删除 掉 id 是 很 重要 的 ， 和 否则 在 页 面 的 结尾 中 就 会 出 


因为 在 删除 的 时 候 


C100. 这 行 代码 将 下 元 素 加 入 其 父 元 素 uL 当中 。 接 下 来 的 两 行 用 row 中 相应 的 数据 更 新 


li 的 子 元 素 label 和 calories. 


经 过 上 述 操作 处 理 后 ，Date 面板 会 操作 从 数据 库 中 检索 出 来 的 数据 ， 设 置 每 一 行 显示 


个 上 元素， 每 一 行 都 有 一 个 lable、calories 和 Delete 按钮 。 如 果 再 创建 一 些 行 ， 就 需要 加 上 一 


些 CSS， 让 界面 变 得 更 美观 。 所 以 将 下 面 的 CSS 代码 保存 到 文件 123.css 


中 ， 并 且 需 要 将 这 
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个 文件 放 在 和 HTML 同一 层 目 录 下 。 


#date ut li{ 
position:relative; 
} 
#date ul li span { 
color: #FFFFFF; 
text-shadow:0 Ipx 2px rgba(0,0,0,.7); 
} 
#date ul li.delete { 
position: absolute; 
top: 5px; 
right: 6px; 
font-size: 12px; 
line-height: 30px; 
padding: 0 3px; 
border-width: 0 Spx; 
-webkit-barder-image: url(themes/jqt/img/button.png) 0 5 0 5; 
} 


然后 在 文件 index.html 的 head 部 分 添加 如 下 代码 以 便 连 接 到 文件 123.css。 


<link type="text/css"rel="stylesheet"media="sc reen"href="123.css"> 


尽管 现在 Delete 按钮 看 起 来 更 像 一 个 按钮 了 ， 但 是 点 击 这 些 按钮 时 却 没有 任何 反应 。 这 
EAN CATE (span) 标签 来 实现 的 按钮 ， 这 在 HTML 页 面 中 是 一 个 无 法 交互 的 元 素 。 


4. 删除 行 
为 了 让 Delete 按钮 起 作用 ， 需 要 使 用 jQuery 将 它们 和 点 击 事件 绑 定 起 来 。 与 Dates 面板 
中 的 条 目 不 同 ，Date 面板 中 的 条 目 不 是 静态 的 ， 这 说 明 它 们 的 添加 和 删除 跟 用 户 的 session 4H 


关 。 其 实 当 启动 程序 时 ，Date 面板 上 并 没有 可 见 的 条 目 ， 因 此 也 没有 什么 可 以 绑 定 到 click 事 
件 上 。 


解决 方案 是 当 Delete 按钮 在 refreshEntriesO 函 数 被 创建 时 ， 将 它们 绑 定 到 click 事件 上 
为 了 做 到 这 点 ， 需 要 在 for 循环 的 最 后 添加 如 下 加 粗 的 代码 : 


newEntryRow.find(‘.calories').text( row.calories); 


newEntryRow.find('.delete").click(function()( //(1) 
var clickedEntry=$(this).parent(); /K2) 
var clickedEntryld-clickedEntry.data('entryId"); AO) 
deleteEntryByld(clickedEntryld); WEN 


clickedEntry.slideUp(); 
D: 


(1) 这 个 函数 只 在 date 元 素 的 ID 中 寻找 任何 有 delete 这 个 类 的 元 素 ， 并 设置 它们 的 
clickO 函 数 。 这 个 clickO 函 数 允 许 用 一 个 匿名 函数 作为 参数 来 处 理 点 击 事件 。 

(2) “4 click 事件 被 触发 以 后 ，Delete 按钮 的 父 元素 ( 这 里 是 1i) 被 找到 ， 然 后 被 保存 到 
clickedEntry 变量 中 。 
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(3) 这 行 代码 使 用 函数 refreshEntries() 8) Æ IJ. li 元 素 保 存 的 entryId. 值 来 设置 
clickedEntryId 变量 。 
(4) 这 行 代码 将 被 点 击 元 素 的 ID 传 入 deleteEntryById0 函 数 中 ， 接 下 来 的 一 行 代 码 会 调 
] jQuery 的 slideUpO 函 数 将 工 元 素 从 界面 上 移 除 。 
在 文件 123.js 中 添加 deleteEnt ryById0 函 数 ， 功 能 是 从 数据 库 中 移 除 一 条 记录 。 


function deleteEntryByld(id) { 
db.transaction( 
function(transaction) { 
transaction.executeSql(DELETE FROM entries WHERE id=?;' 
[id], null, errorHandler); 
n 
)s 
j 


然后 打开 一 个 事务 , 并 将 一 个 参数 为 transaction 对 象 的 回调 函数 作为 参数 传 入 transaction 
中 ， 然 后 执行 executeSql0 方 法 。 方 法 中 的 SQL 查询 语句 和 被 点 击 记录 的 ID 作为 两 个 参数 传 
入 。 第 3 个 参数 是 成 功 处 理 函 数 ， 因 为 不 需要 ， 所 以 被 指定 为 null。 再 看 第 4 个 参数 ， 将 其 
指定 为 一 直 使 用 的 错误 处 理 函 数 。 虽 然 用 了 很 多 描述 才 完 成 这 项 功能 ， 但 实际 上 代码 并 不 多 。 
在 演示 文件 123. 中 ， 与 数据 库 交 互 操作 相关 的 全 部 JavaScript 代码 如 下 。 
var jQT=$.jQTouch(t 


1con:'123.png' 

DE 

var db; 

$(document).ready(function() { 
$(‘#createEntry form") .submit(createEntry); 


$(‘#settings form').submit( saveSettings); 
$(‘#settings').bind(‘pageAnimationStart'’,loadSettings); 
$(‘#dates li a').click(function() { 
var dayOffset=this.id; 
var date=new Date(); 
date.setDate(date.getDate()-dayOffset); 
sessionStorage.currentDate=date.getMonth()+1+'/'+ 
date.getDate() + '/1 + 
date.getFullY ear(); . 
refreshEntries(); 
J) 
var shortName = '123'; 
var version = '1.0'; 
var displayName = '123'; 
var maxSize = 65536; 
db = openDatabase(shortName, version, displayName, maxSize); 
db.transaction( 
function(transaction) { 
transaction.executeSql( 
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'CREATE TABLE IF NOT EXISTS entries. + 
' (id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT, ' + 
' | date DATE NOT NULL, food TEXT NOT NULL, . + 

calories INTEGER NOT NULL) ; ' 


); 
Dk 
function loadSettings() t 
$( '#age').val(localStorage.age) ; 
$( '#budget’).val(localStorage. budget) ; 
$( '#weight’).val(localStorage. weight) ; 
} 
function saveSettings() { 
localStorage.age = $(‘#age') .val() ; 
localStorage.budget = $( '#budget') .val() ; 
localStorage.weight= SC '#weight’) .val() ; 
iQT.goBack() ; 
return false, 
} 
function createEntry() { 
var date=sessionStorage.currentDate . 
vat calories = $( ‘#calories').val(); 
var food = $(‘#food').val(); 
db.transaction( 
function(transaction) { 
transaction.executeSql( 
INSERT INTO entries(date, calories, food) VALUES(?, ?, ?);', 
[date, calories, foodl, 
function() { 
refreshEnt ries () ; 
jQT.goBack( ; 
js 


errorHandler 


); 
return false, 
) 
function refreshEntries() { 

var currentDate=sessionStorage. currentDate , 
$('#date hi") .text (currentDate) ; 

$('#date ul li:gt(0)'). remove () ; 

db.transaction( 
fulclction(transaction) { 
transaction. executeSql( 
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'SELECT* FROM entries WHERE date = ? ORDER BY food;', 
[currentDate], 
function (transaction, result) { 
for(var 1-0; i<result.rows.length; i++) { 
var row:result.rows.item(1); 
var newEntryRow-$( '#entryTemplate’) .clone() 
newEnt ryRow. removeAtt rt di) ， 
newEnt ryRow. removeAttr( 'style ; 
newEntryRow.data( 'entryld', row.id) ; 
newEntryRow.appendTo( "date ul')i 
newEntryRow. find(‘.label’).text( row.food) , 
newEntryRow.find( ' .calories) .text ( row.calo ries) ; 
newEnt ryRow.find ( '.delete").click(function() { 
var clickedEntry = $(this).parent(); 
var clickedEntrId = clickedEntry.data('entryId); 
deleteEnt ryByld ( clickedEnt ryId)* 


clickedEntry.slideUp(); 
Dk 
j 

jc 

errorHandler 
); 

j 

JE 
} 


function deleteEntryById(1d) { 
db.transaction ( 
function(transaction) { 
transaction.executeSql('DE LETE FROM entries WHERE id=?;', 
Lidl, null, errorHandler); 
} 
); 
} 
function errorHandler(transaction, error) { 
alert('Oops.Error was '+error.message+' (Code 'terror.code+')'); 
return.true, 
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蓝牙 这 一 名 称 来 自 于 十 世纪 的 一 位 丹麦 国王 Harald Blatand, Blatand 在 英文 


FEA Bluetooth. 在 现实 应 用 中 , 通过 蓝牙 技术 可 以 有 效 地 简化 移动 通信 终端 设备 之 间 的 通 


可 以 被 解 


信 ， 


也 能 够 成 功 地 简化 设备 与 因特网 之 间 的 通信 ， 从 而 使 数据 传输 变 得 更 加 迅速 、 高 效 。 在 本 章 


的 内 容 中 ， 将 详细 介绍 在 Android 系统 中 开发 蓝牙 应 用 程序 的 基本 知识 ， 为 读者 步 入 本 


面 知识 的 学 习 打 下 基础 。 


91 蓝牙 技术 基础 


蓝牙 技术 的 数据 传输 速率 为 1Mbits， 采 用 时 分 双 工 传输 方式 实现 全 双 了 


内 容 中 ， 将 首先 讲解 蓝牙 技术 的 发 展 历程 。 
011 ”蓝牙 技术 的 发 展 历程 


Ja 


[传输 。 在 本 节 的 


蓝牙 技术 由 瑞典 爱立信 公司 创制 ， 爱 立信 早 在 1994 年 就 已 进行 研发 。1997 年 ， 爱 立信 
与 其 他 设备 生产 商 联系 ， 并 激发 了 他 们 对 该 项 技术 的 浓厚 兴趣 。1998 年 2 月 ，5 个 
司 ， 包 括 爱 立信 、 诺 基 亚 、IBM、 东 芝 及 Intel， 组 成 了 一 个 特殊 兴趣 小 组 (SIG)， 
的 目标 是 创建 一 项 全 球 性 的 小 范围 无 线 通 信 技 术 ， 即 现在 的 蓝牙 。 


Bluetooth 无 线 技术 规格 供 全 球 的 成 员 公司 免 费 使 用 。 许 多 行业 的 1 


品 中 实施 此 技术 ， 以 减少 使 用 零乱 的 电线 ， 实 现 无 缝 连 接 、 


跨国 大 公 


他 们 


E [n] 


Bes Ra PARA He TEC 


流传 输 立 体 声 ， 传 输 数据 或 进行 


语音 通信 。Bluetooth 技术 在 2.4 GHz 波段 运行 ， 该 波段 是 一 种 无 需 申请 许可 证 的 
技 、 医 学 无 线 电 波段 。 正 因 如 此 ， 使 用 Bluetooth 技术 不 需要 支付 任何 费用 。 但 必 


何 费用 。 


0.1.2 低 功 耗 蓝牙 的 特点 


业 、 


科 


须 向 手机 
提供 商 注 册 使 用 GSM 或 CDMA, 除了 设备 费用 外 , 不 需要 为 使 用 Bluetooth. 技术 再 支付 任 


Bluetooth 技术 得 到 了 空前 广泛 的 应 用 ， 集 成 该 技术 的 产品 从 手机 、 汽 车 到 医疗 设备 ， 使 
用 该 技术 的 用 户 从 消费 者 、 工 业 市 场 到 企业 等 等 ， 不 一 而 足 。 低 功 耗 ， 小 体积 以 及 低 成 本 的 
芯片 解决 方案 使 得 Bluetooth 技术 甚至 可 以 应 用 于 极 微 小 的 设备 中 。 


{KIEV (Bluetooth Low Energy, BLE) 是 对 传统 蓝牙 BR/EDR 技术 的 补充 。 尽 管 BLE 


和 传统 蓝牙 都 称 之 为 蓝牙 标准 ， 且 共享 射频 ， 但 是 BLE 是 一 个 完全 不 一 相 


备 与 传统 蓝牙 BR/EDR 的 兼容 性 ， 它 是 专 为 小 数据 率 、 离 散 传输 的 应 用 而 设计 的 。 


在 实际 应 用 过 程 中 ，BLE 的 低 功 耗 并 不 是 通过 优化 空 了 


的 无 线 射频 传输 实现 的 ， 而 是 通 
过 改变 协议 的 设计 来 实现 的 。 为 了 实现 极 低 的 功 耗 效果 ， 通 常 BLE 协议 设计 为 : 在 不 必要 射 


的 技术 。BLE AA 


频 的 时 候 ， 将 空 ! 


口 快速 建立 连接 。 


射频 彻底 关 断 。 
与 传统 蓝牙 BR\EDR 相 比 ，BLE 通过 如 下 三 大 特性 实现 低 功 耗 效果 。 
口 缩短 无 线 开 启 时 间 。 
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D 降低 收发 峰值 功 耗 (具体 由 芯片 决定 )。 


缩短 无 线 
栈 来 降低 工作 周期 。 


以 在 3 毫秒 内 完成 连接 的 建立 和 数据 的 传输 。 


在 现实 应 用 中 ， 低 功 耗 设计 可 
输 。 尽 管 如 此 ，BLE 仍然 是 一 种 非常 
采用 了 一 种 改进 的 GFSK ijt 
在 世 片 级 中 提供 了 128 bit AES 加 密 。 
单 模 设 备 可 以 作为 Master 或 者 Slave， 但 是 不 能 


数据 率 为 305Kbit/s, 
栈 。 而 UART 的 速度 、 


du A HE 


Hea Th 


启 时 间 的 第 一 个 技巧 是 只 用 3 个 “广播 ”信道 ， 第 二 个 技巧 是 通过 优化 协议 
一 个 在 广告 的 设备 可 以 自动 和 一 个 在 搜索 的 设备 快速 建立 连接 ， 所 以 可 


来 一 些 牺 牲 ， 例 如 音频 数据 无 法 通过 BLE 来 进行 传 
色 的 技术 ， 依 然 会 支持 跳 频 (37 个 数据 信道 )， 并 且 
吕方 法 来 提高 链 路 的 稳定 性 。BLE 也 仍 是 非常 安全 的 技术 ， 因 为 


司 时 充当 两 种 角色 。 这 意味 着 BLE 只 能 
建立 简单 的 星 状 拓扑 ， 不 能 实现 散射 网 。 在 BLE 的 无 线 电 规范 中 ， 定 义 了 低 功 耗 蓝 牙 的 最 高 


旧 是 ， 这 只 是 理论 数据 。 在 实际 应 用 中 ， 数 据 的 吞吐 量 取 决 于 上 层 协议 
处 理 器 的 能 力 和 主 设备 都 会 影响 数据 吞吐 能 


高 数据 吞吐 能 力 的 BLE 只 有 通过 私有 方案 或 者 基于 GATT Nnotification 〈 蓝 牙 协 议 ) A 


能 实现 。 事 实 上 ， 如 果 是 高 数据 率 或 高 数据 量 的 应 用 ， 蓝 牙 BR/EDR 通常 显得 更 加 省 电 。 


9.1.3 ” 低 功 耗 蓝牙 的 架构 


BLE 协议 架构 总 体 上 分 成 三 层 ， 从 下 到 上 分 别 是 : 控制 器 (Controller). 主机 (Host) 和 


= 


点 用 端 (Apps)。 三 者 可 以 在 同一 芯片 类 9 


是 处 理 射频 数据 的 解析 、 接 收 和 发 送 ; Host 是 控制 不 同 设备 之 间 如 何 进 行 数据 交换 ; 


现 具体 应 用 。 


(1) 控制 器 Controller 


Controller 实现 射频 相关 的 模拟 也 


对 乡 
物理 


接口 是 天 线 ， 对 内 接 
JÆ (Physical Layer, PHY), 链 路 层 (Linker Layer, LL), 直接 测试 模式 (Direct Test Mode, 


AE dU 


DTM) 以 及 主机 控制 器 接口 HCI; 


O 物理 层 PHY。GFSK fi 5 Jis 
channel 间隔 2MHz (经 : 


BJ, 2402MHz~2480MHz, 40 个 通道 
蓝牙 协议 是 1MHz)， 数 据 传输 速率 是 1Mbit/s。 


实现 ， 也 可 以 分 别 在 不 同 芯片 内 实现 。Controller 


Apps 实 


I 数字 部 分 ， 完 成 最 基本 的 数据 发 送 和 接收 ，Controller 


BIZ CT (Host Controller Interface, HCI); #1 


(channel ), 


O 直接 测试 模式 DTM。 为 射频 物理 层 测试 接口 ， 供 射频 数据 分 析 使 用 。 


O 链 路 层 LL。 基 于 PHY ŻE, 
: 广播 通道 


LL 分 2 种 通道 


前 器 包含 


每 两 个 


(advertising channels) 和 数据 通道 (data channels); 广播 


通道 有 3 个 : 37ch (2402MHz). 38ch (2426MHz)、39ch (2480MHz)， 每 次 广播 都 
会 向 这 3 个 通道 同时 发 送 〈 并 不 会 在 这 3 个 通道 之 间 跳 频 )， 以 防止 某 个 通道 被 其 他 


设备 阻塞 ， 以 至 于 设备 无 法 配对 或 


少 了 可 能 会 被 阻塞 ， 多 了 则 会 加 大 功 耗 ， 还 有 


播 数据 ， 之 所 以 定 3 个 广播 通道 仅 是 一 种 权衡 ， 
个 有 意思 的 事情 是 ， 三 个 广播 通道 刚 


好 避 开 了 WiFi 的 lch、6ch、11ch， 所 以 在 BLE 广播 的 时 候 ， 不 至 于 被 WiFi 影响 ; 
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当 BLE 匹配 之 后 ， LL 由 广播 通道 切换 到 数据 通道 ， 数 据 通 道 37 
候 会 在 这 37 个 通道 间 切 换 ， 切 换 规则 在 设备 间 匹 配 时 约定 。 


( 


HCI 作为 一 种 接口 ,存在 于 主机 Host 和 控制 器 Controller “447, ek 
发 送 数据 和 事件 给 主机 ， 主 机 Host 通过 HCI 发 送 命令 和 数据 给 控 甫 
逻辑 上 定义 了 一 系列 的 命令 、 事 件 ; 物理 上 有 UART, SDIO, U 
tele 


9.1.4 


2) 主机 Host/ 控 制 器 Controller/f HCI 


E 意 1 种 或 几 种 。 
低 功 耗 蓝牙 分 类 


BLE 通常 应 用 在 传感器 和 智能 手机 或 者 平板 电脑 的 通信 中 。 到 目前 为 
能 机 和 平板 电脑 支持 BLE, 如 iPhone 4S 以 后 的 Apple FHL, Motorola Razr 和 the new iPad 及 
其 以 后 的 iPad. Android THU Ce BLE, Android 的 BLE 标准 在 2013 


智能 机 和 平板 会 带 双 模 蓝牙 的 基带 和 协议 栈 ， 协 议 栈 中 包括 GATT 及 以 下 的 所 有 部 分 ， 但 


个 ， 数 据 传输 的 时 


| 器 Host 通过 HCI 


器 Controller; HCI 
SB， 实 际 上 可 能 包含 里 


止 ， 只 有 很 少 的 知 


年 7 月 24 日 发 布 。 


是 
现 ， 实 现时 需要 基 


没有 GATT 之 上 的 具体 协议 。 所 以 ， 这 些 具体 的 协议 需要 在 应 用 程序 中 实 


于 各 个 GATT API 集 。 这 样 有 利于 在 智能 机 端 简单 地 实现 具体 协议 ， 也 可 以 在 智能 机 端 简单 


地 开发 出 一 套 基 于 GATT 的 私有 协议 。 
在 现实 应 用 中 ， 低 功 耗 赣 牙 分 为 单 模 (Bluetooth Smart) 4005€ (Bluetooth Smart Ready) 


因为 不 再 


两 种 设备 。BLE 和 蓝牙 BR/EDR 有 所 区 分 ， 可 以 用 三 种 方式 将 蓝牙 技术 集成 到 具体 设备 中 。 


是 蓝牙 设备 都 可 以 和 另 一 个 蓝牙 设备 进行 互联 ， 所 以 准确 描述 产品 


中 蓝牙 的 版 本 是 


非常 地 重要 的 。 在 接 下 来 的 内 容 中 ， 将 详细 讲解 单 模 蓝 牙 和 双 模 蓝牙 的 基本 知识 


SE 


蓝牙 设备 被 称 为 Bluetooth Smart 设备 ， 并 且 有 专用 的 Logo, WE 9-1 所 示 。 


- Bluetooth 


SMART 


图 9-1 Bluetooth Smart 设备 


在 现实 应 用 中 ， 手 表 、 运 动 传 感 器 等 小 型 设备 通常 是 基于 低 功 耗 单 模 蓝 牙 的 。 为 了 实现 
极 低 的 功 耗 ， 在 硬件 和 软件 上 都 进行 了 优化 ， 这 样 的 设备 只 能 文 持 BLE。 单 模 蓝 牙 芯 片 往往 
是 一 个 带 有 单 模 蓝 牙 协议 栈 的 产品 ， 这 个 协议 栈 通 常 是 芯片 商 免 费 提供 的 。 


(2) 双 模 蓝牙 
双 模 蓝牙 设备 被 称 为 Bluetooth Smart Ready 设备 ， 并 且 有 专用 的 Logo, 
双 模 设备 支持 蓝牙 BR/EDR 和 BLE。 在 双 模 设备 中 ,BR/EDR 和 BLE 


频 前 端 


痢 和 天 线 。 典 型 的 双 模 设备 有 智能 手机 、 平 板 : 


Din. PC 和 Gateway. 


如 图 9-2 所 示 。 
技术 使 用 同一 个 射 
这 些 设 备 可 以 接收 


到 通过 BLE 或 者 蓝牙 BR/EDR 设备 发 送 过 来 的 数据 ， 这 些 设备 往往 都 有 足够 的 供电 能 力 。 双 
模 设 备 和 BLE 设备 通信 的 功 耗 低 于 双 模 设备 和 蓝牙 BR/EDR 设备 通信 的 功 耗 。 在 使 用 双 模 解 
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决 方案 时 ， 需 要 使 用 一 个 外 部 处 理 器 才 可 以 实现 蓝牙 协议 栈 。 


€3 Bluetooth’ 


SMART READY 


K|9-2 Bluetooth Smart Ready 设备 


9.2 分析 Android 系统 中 的 蓝牙 模块 


在 Android 系统 包含 了 对 蓝牙 网 络 协议 栈 的 支持 ， 这 使 得 蓝牙 设备 能 够 无 线 连接 到 其 他 
蓝牙 设备 以 交换 数据 。Android 的 应 用 程序 框架 提供 了 访问 蓝牙 功能 的 API。 这 些 APT 让 应 用 
程序 能 够 无 线 连 接 其 他 蓝牙 设备 ， 实 现 点 对 点 ， 或 点 对 多 的 无 线 交 互 功能 。 

Android 平台 的 蓝牙 系统 是 基于 Bluez 实现 的 , 是 通过 Linux 中 一 套 完整 的 蓝牙 协议 栈 开 
源 实 现 。 当 前 Bluez 被 广泛 应 用 于 各 种 Linux 版 本 中 ， 并 被 芯片 公司 移植 到 各 种 芯片 平台 上 。 
在 Linux 2.6 内 核 中 已 经 包含 了 完整 的 Bluez 协议 栈 ， 在 Android 系统 中 已 经 移植 并 秽 入 进 了 


Bluez 的 用 户 空间 实现 ， 并 且 随 着 硬件 技术 的 发 展 而 不 断 更 新 。 
在 Android 系统 的 蓝牙 模块 中 ， 除 了 内 核 支 持 外 ， 还 需要 有 用 户 空 间 的 Bluez 的 支持 。 


Android 系统 中 蓝牙 模块 的 基本 层次 结构 如 图 9-3 所 示 。 


Android 系统 


本 地 框架 Bluetooth JNI 
bluetooth 适 配 层 和 BluetZ Æ 


图 9-3 Android 蓝牙 系统 的 层次 结构 


在 图 9-3 所 示 的 结构 中 , 从 上 到 下 主要 包括 Java 框架 中 的 BlueTooth 类 、Android 适 配 库 、 
Bluez 库 、 驱 动 程序 和 协议 ， 这 儿 部 分 的 具体 说 明 如 下 。 

(1) Bluez 库 〈 蓝 牙 设备 管理 库 ) 

Android 蓝牙 设备 管理 库 的 路 径 如 下 。 


EN 243 


Android 网 络 开 发 从 入 门 到 精通 


external/bluez/ 


可 以 分 别 生成 库 libbluetooth.so、 libbluedroid.so 和 hcidump 等 众多 相关 的 工具 和 库 。 Bluez 
库 提 供 了 对 用 户 空间 蓝牙 的 支持 ， 在 里 面包 含 了 主机 控制 协议 HCI 以 及 其 他 众多 内 核实 现 协 
议 的 接口 ， 并 且 实 现 了 所 有 蓝牙 应 用 模式 Profile. 

(2) JNI 部 分 

此 部 分 的 代码 路 径 如 下 。 


frameworks/base/core/jni/ 


(3) Java 框架 层 
Java 框架 层 的 实现 代码 保存 在 如 下 的 路 径 ， 


frameworks/base/core/java/android/bluetooth /蓝牙 部 分 对 应 的 应 用 程序 的 API 
frameworks/base/core/java/android/Server /蓝牙 的 服务 部 分 


蓝牙 的 服务 部 分 负责 管理 并 使 用 底层 本 地 服务 , 并 封装 成 系统 服务 。 而 在 android.bluetooth 
部 分 中 则 包含 了 各 个 蓝牙 平台 的 API 部 分 ， 以 供应 用 程序 层 所 使 用 。 

(4) BlueTooth 的 适 配 库 

BlueTooth 适 配 库 的 代码 路 径 如 下 。 


system/bluetooth/ 


此 层 用 于 生成 库 libbluedroid.so 以 及 相关 工具 和 库 ， 能 够 实现 对 蓝牙 设备 的 管理 ， 例 如 蓝 
牙 设 备 的 电源 管理 。 


9.3 Android 系统 的 低 功 耗 蓝牙 协议 栈 


从 Android 4.2 版 本 开始 ，Google 便 更 换 了 Android 的 蓝牙 协议 栈 ， 将 Bluez 换 成 
BlueDroid。 从 Android 4.3 版 本 开始 ， 提 供 了 对 蓝牙 4.0 BLE 的 支持 。 在 本 节 的 内 容 ! 
将 详细 讲解 Android 系统 中 的 蓝牙 4.0 BLE 的 基本 知识 。 


9.3.1 Android 低 功 耗 蓝 牙 协 议 栈 基础 

为 了 确保 Android 系统 可 以 更 好 的 支持 蓝牙 4.0 BLE, Broadcom 公司 特意 推出 了 适应 于 
Android 平台 的 开源 低 功 耗 蓝牙 协议 栈 BlueDroid， 其 开发 文档 和 API 是 开源 代码 ， 在 如 下 的 
地 址 中 保存 。 


https://github.com/briandbl/framework 


在 上 述 开源 代码 中 ， 低 功 耗 蓝牙 API 支持 Android 平台 上 的 低 功 耗 蓝 牙 通 信 功 能 。 通 过 
使 用 BlueDroid 协议 栈 ，Android 应 用 程序 可 以 枚 举 、 发 现 并 访问 低 功 耗 蓝牙 的 外 部 设备 ， 并 
且 实 现 低 功 耗 蓝牙 规范 。 

从 Android 4.2 版 本 开始 ， 低 功 耗 蓝牙 模块 的 整体 结构 如 图 9-4 所 示 。 


244 NH 


第 9 章 agangen | 


Settings Headset Handsfree Opp.hid,22dp .. scias: 
(app/Settings) (app Phone) (apps Bluetooth) packag 


Bluetooth INI 


android. bluetooth ‘Fl (framework/base/core/java/ android) bluetooth) Framework 
Bluetooth ja Bt Bluez (应 用 空间 协议 ) 
MERE: system/bluetooth/. 还 代 藻 :extamaliblumstoeth/,， 
‘libbluadroid.s0 heiattach 
libbluetooth.so 
pre LFS C Cep 


Bluez (HRZ EME) 


Bluetooth (UART. USB|. SDIO) 
Kernel 部 分 


片 


Bluetooth Je, 


Kl9-4 低 功 耗 蓝 牙 模块 的 整体 结构 


注意 : 虽然 从 Android 4.2 版 本 开始 ，JNI 部 分 的 代码 在 packages 层 中 实现 。 但 是 为 了 便 
于 读者 从 视觉 上 更 加 容易 接受 ， 特 将 INI 部 分 绘制 在 了 Framework Eh, 


9.3.2” 低 功 耗 蓝牙 API 详解 


在 接 下 来 的 内 容 中 ， 将 详细 讲解 主要 API 的 基本 功能 和 具体 原理 。 

(1) 本 地 蓝牙 适配器 设备 

本 功能 不 是 由 Broadcom 公司 提供 ， 而 是 由 Android SDK 提供 ， 源 码 位 于 如 下 的 目 
录 中 。 


framework/base/core/java/android.bluetooth/BluetoothA dapter.java 


文件 BluetoothAdapter.java 实现 了 所 有 蓝牙 交互 的 入 口 。 通 过 使 用 类 BluetoothAdapter 可 
以 实现 如 下 的 功能 。 

口 发 现 其 他 的 蓝牙 设备 ， 碍 询 匹 配 的 设备 集 。 

口 使 用 一 个 已 知 蓝牙 地 址 来 初始 化 蓝牙 设备 BluetoothDevice。 

口 创建 一 个 能 够 监听 其 他 设备 通信 的 类 BluetoothSocket。 

文件 BluetoothAdapterjava 的 主要 实现 代码 如 下 。 
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public static synchronized BluetoothAdapter getDefaultAdapter() { 
if (sAdapter == null) { 
[Binder b = ServiceManager.getServicej BLUETOOTH MANAGER SERVICE); 
if (b != null) { 
IBluetoothManager managerService = IBluetoothManager.Stub.asInterface(b); 
sAdapter = new BluetoothAdapter(managerService); 
} else { 
Log.e(TAG, "Bluetooth binder is null"); 


} 
return sAdapter; 


j 
BluetoothAdapter(IBluetoothManager managerService) { 
if (managerService == null) { 
throw new IllegalArgumentException("bluetooth manager service is null"); 
j 


try { 
mService = managerService.registerA dapter(mManagerCallback); 


} catch (RemoteException e) {Log.e(TAG, "", e);} 
mManagerService = managerService; 
mLeScanClients = new HashMap<LeScanCallback, GattCallback Wrapper>(); 
} 
public BluetoothDevice getRemoteDevice(byte[] address) { 
if (address == null || address.length != 6) { 
throw new IllegalArgumentException("Bluetooth address must have 6 bytes"); 
} 
return new BluetoothDevice(String.format("%02X:%02X:%02X:%02X:%02X:%02X", 
address[0], address[1], address[2], address[3], address[4], address[5])); 
} 
public int getState() { 
try { 
synchronized(mManagerCallback) { 
if (mService != null) 
{ 
intstate- mService.getState(); 
if (VDBG) Log.d(TAG, "" + hashCode() + ": getState(). Returning " + state); 


return state; 


} 
} catch (RemoteException e) {Log.e(TAG, "", e);} 
if (DBG) Log.d(TAG, "" + hashCode() +": getState(): mService = null. Returning STATE OFF"); 
return STATE OFF; 
} 
public String getAddress() { 


try { 
return mManagerService.getAddress(); 
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} catch (RemoteException e) (Log.e(TAG, "", e);} 


return null; 
} 
public String getName() { 
try { 
return mManagerService.getName(); 
} catch (RemoteException e) {Log.e(TAG, "", e);} 
return null; 
} 


public int getScanMode() { 
if (getState() != STATE ON) return SCAN MODE NONE; 
try { 
synchronized(mManagerCallback) { 
if (mService != null) return mService.getScanMode(); 
} 
} catch (RemoteException e) {Log.e(TAG, "", e);} 
return SCAN MODE NONE; 
j 
public boolean setScanMode(int mode, int duration) { 
if (getState() !- STATE ON) return false; 
try { 
synchronized(mManagerCallback) { 
if (mService != null) return mService.setScanMode(mode, duration); 
} 
} catch (RemoteException e) {Log.e(TAG, "", e);} 
return false; 
j 
public boolean setScanMode(int mode) { 
if (getState() != STATE ON) return false; 
return setScanMode(mode, getDiscoverableTimeout()); 
j 
public int getDiscoverableTimeout() { 
if (getState() != STATE ON) return -1; 
try { 
synchronized(mManagerCallback) { 
if (mService != null) return mService.getDiscoverableTimeout(); 
} 
} catch (RemoteException e) {Log.e(TAG, "", e);} 
return -1; 
} 
public void setDiscoverableTimeout(int timeout) { 
if (getState() != STATE_ON) return; 
try { 
synchronized(mManagerCallback) { 
if (mService != null) mService.setDiscoverableTimeout(timeout); 
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} catch (RemoteException e) {Log.e(TAG, "", e);} 
} 
public boolean startDiscovery() { 

if (getState() != STATE ON) return false; 


try { 
synchronized(mManagerCallback) { 
if (mService != null) return mService.startDiscovery(); 
} 
} catch (RemoteException e) {Log.e(TAG, "", e);} 
return false; 


} 


public boolean cancelDiscovery() { 
if (getState() != STATE ON) return false; 


try { 
synchronized(mManagerCallback) { 
if (mService != null) return mService.cancelDiscovery(); 
} 
} catch (RemoteException e) {Log.e(TAG, "", e);} 
return false; 


j 


public boolean isDiscovering() { 
if (getState() !- STATE ON) return false; 


try { 
synchronized(mManagerCallback) { 
if (mService != null ) return mService.isDiscovering(); 
} 
} catch (RemoteException e) {Log.e(TAG, "", e);} 
return false; 


j 


public Set<BluetoothDevice> getBondedDevices() { 
if (getState() != STATE ON) { 
return toDeviceSet(new BluetoothDevice[0]); 
j 
try { 
synchronized(mManagerCallback) { 
if (mService != null) return toDeviceSet(mService.getBondedDevices()); 
} 
return toDeviceSet(new BluetoothDevice[0]); 
} catch (RemoteException e) (Log.e(TAG, "", e);} 
return null; 
j 
public int getConnectionState() 1 
if (getState() !- STATE ON) return BluetoothAdapter STATE DISCONNECTED; 
try { 
synchronized(mManagerCallback) { 
if (mService != null) return mService.getAdapterConnectionState(); 
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} catch (RemoteException e) {Log.e(TAG, "getConnectionState:", e);) 
return BluetoothAdapter STATE DISCONNECTED; 
} 
public int getProfileConnectionState(int profile) { 
if (getState() != STATE ON) return BluetoothProfile STATE DISCONNECTED; 
try { 
synchronized(mManagerCallback) { 
if (mService != null) return mService.getProfileConnectionS tate(profile); 
j 
} catch (RemoteException e) { 
Log.e(TAG, "getProfileConnectionState:", e); 
j 
return BluetoothProfile STATE DISCONNECTED; 
} 
public BluetoothServerSocket listenUsingRfcommOn(int channel) throws IOException { 
BluetoothServerSocket socket = new BluetoothServerSocket( 
BluetoothSocket. TYPE RFCOMM, true, true, channel); 
int errno = socket. mSocket.bindListen(); 
if (errno != 0) { 
throw new IOException("Error: " + errno); 
j 
return socket; 
j 
public BluetoothServerSocket listenUsingRfcommWithServiceRecord(String name, UUID uuid) 
throws IOException { 
return createNewRfcommSocketAndRecord(name, uuid, true, true); 
} 
private BluetoothServerSocket createNewRfcommSocketAndRecord(String name, UUID uuid, 
boolean auth, boolean encrypt) throws IOException { 
BluetoothServerSocket socket; 
socket = new BluetoothServerSocket(BluetoothSocket. TYPE RFCOMM, auth, 
encrypt, new ParcelUuid(uuid)); 
socket.setServiceName(name); 
int errno = socket.mSocket.bindListen(); 
if (errno != 0) { 
throw new IOException("Error: " + errno); 
j 


return socket; 


j 


(2) 请 求 远程 蓝牙 设备 
本 功能 也 是 由 Android SDK 提供 的 ， 源 人 码 位 于 如 下 的 目录 中 。 


framework/base/core/java/android.bluetooth/BluetoothDevice.java 


X fF BluetoothDevice.java 代表 一 个 远程 蓝牙 设备 ， 可 以 文 持 BLE 低 功 耗 设备 、BR/EDR 
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设备 或 Dual-mode 类 型 的 设备 。 通 过 使 用 类 BluetoothDevice 可 以 实现 如 下 的 功能 。 
口 请 求 获 取 远 程 蓝牙 设备 的 连接 。 
O 查询 获取 远程 蓝牙 设备 的 名 称 、 地 址 、 类 和 链接 状态 。 
文件 BluetoothDevice.java 的 主要 实现 代码 如 下 。 


static [Bluetooth getService() { 
synchronized (BluetoothDevice.class) { 
if (sService == null) { 
BluetoothAdapter adapter = BluetoothA dapter.getDefaultAdapter(); 
sService = adapter. getBluetoothService(mStateChangeCallback); 


j 


return sService; 


} 
static IBluetoothManagerCallback mStateChangeCallback = new IBluetoothManagerCallback.Stub() { 


public void onBluetoothServiceUp(IBluetooth bluetoothService) 
throws RemoteException { 
synchronized (BluetoothDevice.class) { 
sService = bluetoothService; 


} 


public void onBluetoothServiceDown() 
throws RemoteException { 
synchronized (BluetoothDevice.class) { 
sService = null; 


} 
} 
h 
if (!BluetoothAdapter.checkBluetoothAddress(address)) { 
throw new IllegalArgumentException(address + " is not a valid Bluetooth address"); 
} 
mAddress = address; 
} 
@Override 


public boolean equals(Object o) { 
if (o instanceof BluetoothDevice) { 
return mAddress.equals(((BluetoothDevice)o).getAddress()); 
} 


return false; 
} 
@Override 
public int hashCode() { 
return mAddress.hashCode(); 


} 
public static final Parcelable.Creator<BluetoothDevice> CREATOR = 
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new Parcelable.Creator<BluetoothDevice>() { 


public BluetoothDevice createFromParcel(Parcel in) { 


return new BluetoothDevice(in.readString()); 


} 


public BluetoothDevice[] newArray(int size) { 


return new BluetoothDevice[size]; 


D 


(3) 实现 客户 端的 低 功 耗 蓝牙 规范 
TE Broadcom 公司 提供 的 源码 中 ,文件 BleClientProfile.java 实现 客户 端的 低 功 耗 蓝牙 规范 。 
在 应 用 中 要 想 访问 远程 设备 中 的 低 功 耗 赣 牙 规 范 ， 就 必须 继承 类 BleClientProfile， 并 且 需 要 


提供 要 访问 的 规范 的 必须 参数 和 服务 标识 。 通 过 BleClientProfile 的 派生 类 可 以 发 起 一 个 远程 
设备 的 连接 ， 并 . 


ay 


日 一 个 BleClientProfile 类 可 能 会 包含 多 个 BleClientService 对 象 的 实例 。 文 伯 


BleClientProfile.java 的 具体 实现 代码 如 下 。 


/下 面 是 构造 方法 ， 功 能 是 给 当前 规范 的 UUID 和 客户 端 应 用 上 下 文 创建 一 个 BleClientProfile 
public BleClientProfile(Context context, BleGattID profileUuid) 


1 


Log.d(TAG, "new profile" + profileUuid.toString()); 
this.mContext = context; 

this. mAppUuid = profileUuid; 

this.mConnectedDevices = new ArrayList<BluetoothDevice>(); 


this. mConnectingDevices = new ArrayList<BluetoothDevice>(); 


this. mDisconnectingDevices = new ArrayList<BluetoothDevice>(); 

this. mClientIDToDeviceMap = new HashMap<Integer, BluetoothDevice>(); 
this. mDeviceToClientIDMap = new HashMap<BluetoothDevice, Integer>(); 
this.mCallback = new BleClientCallback(); 

this.mSvcConn = new GattServiceConnection(context); 


} 


[** 


* 初始 化 BleClientProfile 对 象 


vil 


public void init(ArrayList<BleClientService> requiredServices, 


ArrayList<BleClientService> optionalServices) 


Log.d(TAG, "init ("+ this. mAppUuid + ")"); 
this. mRequiredServices = requiredServices; 


this. mOptionalServices = optionalServices; 
IBinder b = ServiceManager.getService(BleConstants.BLUETOOTH LE SERVICE); 


if (b == null) ( 


throw new RuntimeException("Bluetooth Low Energy service not available"); 


j 


this.mSvcConn.onServiceConnected(null, b); 


[** 
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* 清楚 和 此 规范 有 关 的 资源 
Set 

public synchronized void finish() 

{ 


if (this.mSvcConn !- null) { 
this.mContext.unbindService(this.mSvcConn); 
this.mSvcConn - null; 


} 

@Override 

[** 
* 返 回 此 规范 是 否 已 经 成 功 注册 到 蓝牙 协议 栈 中 . 
* @see {@link #registerProfile()} 
Sei 

public boolean isProfileRegistered() 

{ 


Log.d(TAG, "isProfileRegistered (" + this. mAppUuid + ")"); 
return this.mClientIf != BleConstants; GATT SERVICE PRIMARY; 


* 注册 规范 到 蓝牙 协议 栈 
St 
public int registerProfile() 


1 


int ret = BleConstants.GATT SUCCESS; 
Log.d(TAG, "registerProfile (" + this mAppUuid + ")"); 


if (this. mClientlf == BleConstants.GATT SERVICE PRIMARY) 


try 


this.mService.registerApp(this.mAppUuid, this.mCallback); 
} catch (RemoteException e) { 

Log.e(TAG, e.toString()); 

ret = BleConstants.SERVICE UNAVAILABLE; 


j 


return ret; 


* 注 销 蓝牙 协议 栈 中 的 规范 
E 
public void deregisterProfile() 
{ 


Log.d(TAG, "deregisterProfile ("+ this mAppUuid + ")"); 
if (this.mClientIf != BleConstants.GATT SERVICE PRIMARY) 


252 BH 


第 9 章 


try { 
this.mService.unregisterA pp(this.mClientIf); 
} catch (RemoteException e) { 
Log.e(TAG, "deregisterProfile() - " + e.toString()); 


} 

[** 

* 设置 一 个 活跃 连接 设备 的 加 密 等 级 

t 

public void setEncryption(BluetoothDevice device, byte action) 


1 


try 
1 

this.mService.setEncryption(device.getAddress(), action); 
} catch (RemoteException e) { 

Log.e(TAG, e.toString()); 


* 当 请 求 后 台 连 接 时 ， 定 义 本 地 设备 扫描 远程 低 功 耗 设备 的 强度 
2 
public void setScanParameters(int scanInterval, int scanWindow) 
{ 
try 
{ 
this. mService.setScanParameters(scanInterval, scanWindow); 
} catch (RemoteException e) { 
Log.e(TAG, e.toString()); 


* 建立 一 个 到 远程 设备 的 GATT 连接 
2 
public int connect(BluetoothDevice device) 


1 


Log.d(TAG, "connect ("  this.mAppUuid + ")" + device.getAddress()); 


int ret = BleConstants.GATT SUCCESS; 
synchronized (this.mConnectingDevices) ( 
this.mConnectingDevices.add(device); 


} 
synchronized (this. mDisconnectingDevices) { 
this. mDisconnectingDevices.remove(device); 


try 


this. mService.open(this.mClientlf, device.getAddress(), true); 


开发 蓝牙 应 用 程序 


EN 253 


Android 网 络 开发 从 入 门 到 精通 


j 


[** 


} catch (RemoteException e) { 
Log.e(TAG, e.toString()); 
ret = BleConstants.GATT ERROR; 
j 


return ret; 


* 准备 一 个 到 远程 蓝牙 设备 的 后 台 连 接 


public int connectBackground(BluetoothDevice device) 


1 


j 


[** 


Log.d(TAG, 
"connectBackground ("+ this.mAppUuid + ")"  device.getA ddress()); 
int ret = BleConstants.GATT SUCCESS; 
synchronized (this.mConnectingDevices) ( 
this.mConnectingDevices.add(device); 
} 
synchronized (this.mDisconnectingDevices) { 
this.mDisconnectingDevices.remove(device); 


try 


this.mService.open(this.mClientIf, device.getAddress(), false); 
} catch (RemoteException e) { 

Log.e(TAG, e.toString()); 

ret = BleConstants.GATT ERROR; 
} 


return ret; 


* 停止 监听 远程 蓝牙 设备 试图 发 起 的 链接 


public int cancelBackgroundConnection(BluetoothDevice device) 


1 


254 BH 


Log.d(TAG, "cancelBackgroundConnection (" + this.mAppUuid 
+") - device " + device.getA ddress()); 


int ret = BleConstants.GATT SUCCESS; 
try 
1 
this.mService.close(this.mClientlf, device.getAddress(), 0, false); 
} catch (RemoteException e) { 
Log.e(TAG, e.toString()); 
ret = BleConstants. GATT ERROR; 
j 


return ret; 
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} 
[** 
* WT IFT SIC RECS] GATT 连接 
= 
public int disconnect(BluetoothDevice device) 
{ 
Log.d(TAG, 
"disconnect (" + this.mAppUuid + ") - device " + device.getAddress()); 
synchronized (this.mDisconnectingDevices) { 
this.mDisconnectingDevices.add(device); 
j 
int ret = BleConstants.GATT SUCCESS; 
try 
{ 
this.mService.close(this.mClientlIf, 
device.getAddress(), 
((Integer) this.mDeviceToClientIDMap.get(device)).intValue(), 
true); 
} catch (RemoteException e) { 
Log.e(TAG, e.toString()); 
ret = BleConstants. GATT ERROR; 
j 
return ret; 
j 
[** 
* 刷新 当前 客户 端的 规范 
ey 
public int refresh(BluetoothDevice device) 
1 
Log.d(TAG, 
"refresh ("+ this.mAppUuid + ") - address = "+ device.getAddress()); 
if (isDeviceDisconnecting(device)) { 
Log.d(TAG, "refresh ("+ this. mAppUuid 
+") - Device unavailable!"); 
return BleConstants.GATT ERROR; 
j 
this.mRequiredServices.get(BleConstants.GATT SERVICE PRIMARY ).refresh(device); 
return BleConstants.GATT SUCCESS; 
j 
[** 
* 刷新 当前 规范 包含 的 特定 服务 
= 


public int refreshService(BluetoothDevice device, BleClientService service) 


1 
Log.d(TAG, "refreshService ("+ this.mAppUuid + ") address = s " 
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+ device.getAddress() + "service = " + service.getServiceld()); 
return 0; 


* 在 已 经 连接 的 设备 列表 中 查找 指 定 蓝 牙 设备 的 地 址 
St 
public BluetoothDevice findConnectedDevice(String address) 


1 


BluetoothDevice ret = null; 
synchronized (this.mConnectedDevices) { 
for (int i = 0; i != this.mConnectedDevices.size(); i++) { 
BluetoothDevice d — (BluetoothDevice) this.mConnectedDevices.get(1); 
if (address.equalsIgnoreCase(d.getA ddress())) { 
ret = d; 
break; 


return ret; 


* 返回 当前 连接 和 等 待 连接 中 的 所 有 远程 设备 集合 
=f 
public BluetoothDevice[] getPendingConnections() 


1 


return (BluetoothDevice[]) this.mConnectingDevices.toArray(new BluetoothDevice[0]); 


* 设 置 一 个 蓝牙 设备 地 址 ， 在 等 待 连接 设备 列表 中 查找 一 个 远程 设备 
St 
public BluetoothDevice findDevice WaitingForConnection(String address) 
{ 
BluetoothDevice ret = null; 
synchronized (this.mConnectingDevices) { 
for (int i = 0; i < this. mConnectingDevices.size(); i++) { 
BluetoothDevice d = (BluetoothDevice) this. mConnectingDevices.get(1); 
if (address.equalsIgnoreCase(d.getAddress())) { 
ret = d; 
break; 


return ret; 


(4) 创建 一 个 代表 客户 端 角色 设备 上 的 低 功 耗 蓝 牙 服务 派生 类 
在 Broadcom 公司 提供 的 源码 中 ， 文 件 BleClientService.java 定义 了 一 个 派生 类 ， 此 派生 


256 BH 


第 9 章 开发 蓝牙 应 用 程序 


类 代表 了 客户 端 角色 设备 上 的 低 功 耗 蓝牙 服务 。 通 过 这 个 派生 类 可 以 允许 应 用 程序 读 写 低 功 


耗 蓝 牙 服务 的 特征 ， 并 且 在 特征 改变 时 注 
如 下 。 


/定义 代表 客户 端的 低 功 耗 服务 


public abstract class BleClientService 


1 


private static String TAG = "BleClientService"; 

private BleClientProfile mProfile — null; 

private BleGattID mServiceld = null; 

private HashMap<BluetoothDevice, ArrayList<ServiceData>> mdeviceToDataMap = 
new HashMap<BluetoothDevice, ArrayList<ServiceData>>(); 

private BleCharacteristicDataCallback mCallback = 
new BleCharacteristicDataCallback(); 

private boolean mReadDescriptors = true; 


[** 


* 创 建 一 个 新 的 低 功 耗 蓝牙 服务 的 UUID 


* 


* @param serviceld 

E 
public BleClientService(BleGattID serviceld) 
{ 

mServiceld = serviceld; 
if (mServiceld.getServiceType()== BleConstants.GATT UNDEFINED) 
mServiceld.setServiceType(BleConstants.GATT SERVICE PRIMARY); 

j 
[** 

* 返回 服务 的 UUID 

i 
public BleGattID getServiceld() 
{ 

return mServiceld; 

} 
[** 

* 写 操作 远程 设备 上 的 一 个 特性 

=f 
public int writeCharacteristic(BluetoothDevice remoteDevice, int instanceld, 

BleCharacteristic characteristic) 


Log.d(TAG, "writeCharacteristic"); 
int ret = BleConstants.GATT SUCCESS; 
int connID = BleConstants.GATT INVALID CONN ID; 


EJ AU. SCE BleClientService.java 的 主要 实现 代码 


if ((connID = mProfile.getConnIdForDevice(remoteDevice)) == BleConstants.GATT_ 
INVALID CONN ID) { 


return BleConstants.GATT INVALID CONN ID; 


EN 257 


Android 网 络 开发 从 入 门 到 精通 


ServiceData s = getServiceData(remoteDevice, instanceld); 
if (s == null) { 
return ret; 
j 
s.writeIndex — s.characteristics.indexOf(characteristic); 
if ((s.characteristics != null) && (s.writeIndex >= BleConstants.GATT SERVICE PRIMARY)) { 
Log.d(TAG, "writeCharacteristic found characteristic in array:"); 
Log.d(TAG, 
"Service = [instanceID = " + instanceld + " svcid =" 
+ mServiceld.toString() + " serviceType =" 
+ mServiceld.getServiceType()); 
Log.d(TAG, "CharID = [instanceID = " + characteristic.getInstanceID() 
+" svcid =" + characteristic.getID().toString()); 
BleGattID svcId = new BleGattID(instanceld, mServiceld.getUuid(), 
mServiceld.getServiceType()); 
BleGattID cID — characteristic.getID(); 
BluetoothGattCharID charID = new BluetoothGattCharID(sveld, cID); 
try 
{ 
if (characteristic.isDirty()) { 
if (characteristic.getWriteType()== BleConstants.GATT SUCCESS) 
characteristic.setWriteT ype(2); 
characteristic.setDirty(false); 
mProfile.getGattService().writeCharValue(connID, charID, 
characteristic.getWriteType(), characteristic.getAuthReq(), 
characteristic.getValue()); 
j 
else if (!characteristic.getDirty DescQueue().isEmpty()) { 
ArrayList«BleDescriptor- descList = 
characteristic.getDirtyDescQueue(); 
BleDescriptor descObj = descList.get(0); 
Log.d(TAG, "writeCharacteristic - descriptor — " 
+ descObj.getID().toString()); 
if (descObj.isDirty()) { 
BluetoothGattCharDescrID descID = new BluetoothGattCharDescrID( 
sveld, cID, descObj.getID()); 
descObj.setDirty(false); 
mProfile.getGattService().writeCharDescrValue(connID, 
descID, descObj.getWriteType(), descObj.getAuthReq(), 
descObj.getValue()); 


} 
} 
else 
{ 
onWriteCharacteristicComplete(0, remoteDevice, characteristic); 
} 
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} 
} else { 
onWriteCharacteristicComplete(0, remoteDevice, characteristic); 
} 
return ret; 
} 
(5) 定义 服务 器 端的 角色 的 低 功 耗 规 范 


Tr 


在 Broadcom 公司 提供 的 源码 中 ， 文 伯 


功 耗 规范 ， 在 创建 一 个 新 的 低 功 耗 规范 之 前 ， 
所 必须 的 参数 和 服务 。 通 常 来 说 ， 一 个 


BleServerService 对 象 。 在 BleServerProfile 派生 的 类 中 ， 包 含 低 功 耗 规范 中 定义 服务 的 


BleServerProfile.java 定义 了 服务 器 


端的 角色 的 低 
需要 先 继承 于 这 个 类 ， 并 提供 标识 要 访问 规范 


BleServerProfile 派生 的 类 包含 一 个 或 多 个 


pa 


BleServerService 对 象 的 集合 。 文 件 BleServerProfile.java 的 主要 实现 代码 如 下 。 


public abstract class BleServerProfile 


1 


private static final boolean D = true; 


private static final String TAG = "BleServerProfile' 


private Context mCtxt — null; 
private BleGattID mAppid; 
ArrayList<BleServerService> mServiceArr = null; 


lis 
H 


private HashMap<String, Integer> mConnMap = null; 


private HashMap<Integer, Integer» mMtuMap = null; 


private IBluetoothGatt mService; 

private int mSvcCreated = 0; 

private int mSvcStarted = 0; 

private byte mAppHandle = —1; 

private int mProfileStatus — 2; 

private GattServiceConnection mSvcConn; 


public BleServerProfile(Context ctxt, BleGattID appld, 
AtrayList<BleServerService> serviceArr) 


mAppid = appld; 
mCtxt = ctxt; 
mServiceArr = serviceArr; 


mConnMap = new HashMap<String, Integer>(); 
mMtuMap = new HashMap<Integer, Integer>(); 
mSvcConn = new GattServiceConnection(null); 


Intent i = new Intent(); 


i.setClassName("com.broadcom.bt.app.system", 


"com.broadcom.bt.app.system.GattService"); 


mCtxt.bindService(i, mSvcConn, 1); 


throw new RuntimeException("Not implemented"); 
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诺 取 消 和 此 规范 相关 的 资源 */ 
public synchronized void finish() 


{ 
if (mSvcConn != null) { 
mCtxt.unbindService(mSvcConn); 
mSvcConn = null; 
j 
} 
public void finalize() 
{ 
finish(); 
} 
byte getAppHandle() 
{ 
return mAppHandle; 
} 
HashMap<String, Integer> getConnMap() { 
return mConnMap; 
} 
POE ROS TI AS 
void initProfile() 
1 
Log.i("BleServerProfile", "initProfile()"); 
try { 
mService.registerServerProfileCallback(mAppid, 
new BleServerProfileCallback(this)); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to start profile", t); 
j 
} 
void notifyAction(int event) 
{ 
if ((event == 0) && (++mSvcCreated == mServiceArr.size())) 
1 
Log.i("BleServerProfile", 
"All services created successfully. Calling onInitialized"); 
onInitialized(true); 
} else if (event == 4) && (--mSvcCreated == 0)) 
{ 
Log.i("BleServerProfile", 
"All services stopped successfully. Calling onStopped"); 
onStopped(); 
} else if ((event == 2) && (++mSvcStarted == mServiceArr.size())) 
1 


Log.i("BleServerProfile", 
"All services started successfully. Calling onStarted"); 
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onStarted(true); 
} else if (event == 1) { 
Log.i("BleServerProfile", 
"One of the services creation failed. Calling onInitialized"); 
mProfileStatus — 2; 
onInitialized(false); 
} else if (event == 3) { 
Log.i("BleServerProfile", 
"One of the services start failed. Calling onStarted"); 
mProfileStatus — 2; 
onStarted(false); 
} else { 
Log.e("BleServerProfile", "Unknown action from a service"); 


} 
ISO AUC SY IT HR Ss 
public void startProfile() 


1 


Log.i("BleServerProfile", "startProfile()"); 
if (mService == null) { 
Log.i("BleServerProfile", "Remote service object is null.. Returning.."); 
return; 
} 
for (int i = 0; i < mServiceArr.size(); i++) { 
if (!((BleServerService) mServiceArr.get(i)).isRegistered()) { 
Log.i("BleServerProfile", 
"One of the services is not registered. Stopping all the services"); 
stopProfile(); 
return; 


j 


((BleServerService) mServiceArr.get(1)).startService(); 


} 
旋 停 止 和 此 规范 有 关 的 所 有 服务 */ 
public void stopProfile() 


{ 
Log.i("BleServerProfile", "stopProfile()"); 
for (int i = 0; i < mServiceArr.size(); i++) 
((BleServerService) mServiceArr.get(1)).stopService(); 
} 


从 注销 所 有 相关 的 服务 六 
public void finishProfile() 
i 


Log.i("BleServerProfile", "finishProfile()"); 
for (int i = 0; 1 < mServiceArr.size(); it) { 
((BleServerService) mServiceArr.get(1)).deleteService(); 
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} 
try 
{ 
mService.unregisterServerProfileCallback(mAppHandle); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to stop profile", t); 


return; 


} 

ERERKEN Pel ROS 

public void setMtuSize(int connld, int mtuSize) 

1 
Log.i("BleServerProfile", "setMtuSize"); 
mMtuMap.put(Integer.valueOf(connld), Integer.valueOf(mtuSize)); 

} 

P2 — BR ERC ar E EAT Tue Se CV 

public void setEncryption(String bdaddr, byte action) 


i 
try 
1 
mService.setEncryption(bdaddr, action); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to set encryption for connection", t); 
j 
j 


/* 当 已 经 请 求 一 个 后 台 链接 时 ， 定 义 本 地 设备 扫 措 远程 低 功 耗 设备 的 强度 % 


public void setScanParameters(int scanInterval, int scanWindow) 


i 
try 
1 
mService.setScanParameters(scanInterval, scanWindow); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to set scan parameters", t); 
j 
j 


/# 打 开 一 个 外 设 GAP 客户 端的 连接 */ 
public void open(String bdaddr, boolean isDirect) 


{ 
try 
{ 
mService.GATTServer Open(mAppHandle, bdaddr, isDirect); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to open Gatt connection", t); 
j 
j 


T 
‘= 


PGE M PETEXETI Pb xe GATT 客户 端的 打开 操作 */ 
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public void cancelOpen(String bdaddr, boolean isDirect) 


{ 
try 
{ 
mService.GATTServer CancelOpen(mAppHandle, bdaddr, isDirect); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to open Gatt connection", t); 
return; 
j 
} 


[RFA] AS poe BEI OCHS i HO XE Ben 
public void close(String bdaddr) 


{ 
try 
{ 
mService.GATTServer_Close(((Integer) mConnMap.get(bdaddr)) 
ntValue()); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to open Gatt connection", t); 
return; 
j 
j 


(6) 创建 低 功 耗 服务 
在 Broadcom 公司 提供 的 源码 中 ， 文 件 BleServerService.java 创建 了 一 个 低 功 耗 服务 ， 这 


是 服务 器 端 角 色 上 的 低 功 耗 规范 的 一 部 分 。 在 BleServerService 的 派生 类 中 包含 了 一 个 或 多 个 


BleCharacteristic 对 象 。 在 应 用 程序 中 ， 需 要 重 写 类 BleServerService 来 实现 一 个 服务 。 文 件 


BleServerService.java 的 主要 实现 代码 如 下 。 


public abstract class BleServerService 


private final String TAG = "BleServerService"; 

private HashMap<Integer, BleCharacteristic> mCharHdlMap = null; 
private HashMap<Integer, BleServerService> mServiceHdlMap = null; 
private HashMap<Integer, AttributeRequestInfo> mAttrReqMap = null; 
private ArrayList<BleCharacteristic> mCharQueue = null; 

private ArrayList<BleDescriptor> mDirtyDescQueue = null; 

private BleGattID mServiceld; 

private BleGattID mAppUuid; 

private BleServerProfile mProfileHandle; 

private IBluetoothGatt mService; 

private int mSvcHandle = -1; 

private byte mSupTransport; 

private BleServiceCallback mGattServiceCallback; 

private boolean isServiceAvailable — false; 


private int mSvcInstance — 0; 
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private boolean isPrimary = false; 

private int mNumHandles; 

private final int CHAR. ADDED = 0; 

private final int CHAR. DESC. ADDED = 1; 
private final int ATTRIBUTE WRITE = 2; 
private final int ATTRIBUTE READ = 3; 
private final int HDL_ VAL INDICATION = 4; 
private final int HDL VAL NOTIFICATION = 5; 
private final int MTU EXCHANGE - 6; 
private final int EXECUTE WRITE - 7; 
private Handler mHandler = new Handler() 


1 

public void handleMessage(Message msg) 

1 

} 
5 
int getConnId(String address) 
{ 

if (this.mProfileHandle == null) 
return -1; 

HashMap connMap = this.mProfileHandle.getConnMap(); 

return ((Integer) connMap.get(address)).int Value(); 
} 


JH PRB, ERU ID HIE — 4 ICUHRERR */ 
public BleServerService(BleGattID serviceld, int numHandles) 
i 
/* * 
* TODO: implement 
=f 
this.mServiceld = serviceld; 
this. mNumHandles = numHandles; 
this. mSupTransport = 2; 
this.mGattServiceCallback = new BleServiceCallback(this); 
this. mCharHdlMap = new HashMap(); 
this. mServiceHdlMap = new HashMap(); 
this. mCharQueue = new ArrayList(); 
this. mAttrReqMap = new HashMap(); 


if (this.mServiceld.getServiceType()== -1) 
this.mServiceld.setServiceType(0); 
throw new RuntimeException("not implemented"); 
} 
PARA, Jaen ID 构造 一 个 新 的 低 功 耗 服务 */ 
public BleServerService(BleGattID serviceld, byte supTransport, int numHandles) 


1 
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this.mServiceld = serviceld; 
this.mNumHandles = numHandles; 
this.mSupTransport = supTransport; 
this.mGattServiceCallback = new BleServiceCallback(this); 
this.mCharHdlMap = new HashMap(); 
this. mCharQueue = new ArrayList(); 
this. mServiceHdlMap = new HashMap(); 
this.mAttrReqMap = new HashMap(); 
if (this. mServiceld.getServiceType()== -1) 

this.mServiceld.setServiceType(0); 

throw new RuntimeException("not implemented"); 


} 
PIAA */ 
protected void initService() 
{ 
if (this.mService != null) 
try { 
this.mService.registerServerServiceCallback(this.mServiceld, 
this. mAppUuid, this. mGattServiceCallback); 
} catch (Throwable t) { 
Log.e("BleServerService", "initService", t); 
} 
} 


PEARS S Mul En! 


public void createService() 


{ 
if (this.mService != null) 
try { 
this.mService. GATTServer CreateService(this.mProfileHandle.getAppHandle(), 
this.mServiceld, this.mNumHandles); 
} catch (Throwable t) 
{ 
Log.e("BleServerService", "createService", t); 
j 
j 


DATE AP BOUE OR Ss 


public void deleteService() 


if (this.mService != null) 
try { 
this.mService.GATTServer_DeleteService(this.mSvcHandle); 
} catch (Throwable t) { 
Log.e("BleServerService", "deleteService ", t); 
j 
/* A FERAS / 
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public void startService() 


{ 
if (this.mService != null) 
try { 
this.mService.GATTServer_StartService(this.mSvcHandle, this.mSupTransport); 
} catch (Throwable t) { 
Log.e("BleServerService", "startService ", t); 
j 
j 
IHR Sai 
public void stopService() 
{ 
if (this.mService != null) { 
this.mProfileHandle.notifyAction(4); 
try { 
this.mService.unregisterServerServiceCallback(this.mSvcHandle); 
this.mService. GATTServer StopService(this.mSvcHandle); 
} catch (Throwable t) { 
Log.e("BleServerService", "stopService ", t); 
} 
} 
} 


放 为 此 服务 添加 一 个 包含 的 服务 */ 
public void addIncludedService(BleServerService service) 
{ 
if (this.mService != null) 
try { 
if (service.isRegistered()) { 
this. mServiceHd|IMap.put(Integer. valueOf(service.getServiceHandle()), 
service); 
this. mService.GATTServer_AddIncludedService(this.mSvcHandle, 
service.getServiceHandle()); 
j 
else { 
Log.i("BleServerService", 
"addIncludedService: Service to be included is not registered."); 
j 
} catch (Throwable t) { 
Log.e("BleServerService", "addIncludedService", t); 


} 
(pr FE ID IT 
public void updateCharacteristic(BleCharacteristic charObj) 


1 


addCharacteristic(charOb;j); 
j 
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庶 当 客户 端 已 经 请 求 读 或 写 一 个 本 地 特性 属性 后 发 送 一 个 响应 */ 
public void sendResponse(String address, int transId, byte[] data, int statusCode) 


{ 
Log.d("BleServerService", "sendResponse() address = " + address + ", transId = " 
+ transId + ",statusCode =" + statusCode); 
if (this.mService == null) { 
Log.e("BleServerService", "sendResponse(): error. GattService not available"); 
return; 
j 
AttributeRequestInfo attrInfo — (AttributeRequestInfo) this.mAttrReqMap 
remove(Integer.valueOf(transId)); 
if (attrInfo == null) 
{ 
Log.e("BleServerService", 
"sendResponse() error. attrInfo not found with transId " + transId); 
return; 
} 
byte[] dataToSend = null; 
if (attrInfo.mOffset == 0) { 
dataToSend = data; 
} else { 
dataToSend = new byte[data.length - attrInfo.mOffset |; 
System.arraycopy(data, attrInfo.mOffset, dataToSend, 0, dataToSend.length); 
j 
try 
{ 
this.mService 
.GATTServer SendRsp( 
attrInfo.mConnld, 
attrInfo.mTranslId, 
(byte) statusCode, 
attrInfo.mAttrHandle, 
attrInfo.mOffset, 
dataToSend, 
(byte) 0, 
false); 
} catch (Throwable t) 
1 
Log.e("BleServerService", "sendResponse(): error", t); 
} 
} 


CI) 描述 低 功 耗 蓝牙 服务 的 特性 


在 Broadcom 公司 提供 的 源码 中 ， 文 件 BleCharacteristic.java 可 以 描述 低 功 耗 蓝 牙 服务 的 


T 


寺 性 。 在 特性 中 包含 了 描述 符 、 实 际 值 和 元 数据 ， 提 供 了 表现 格式 或 便于 阅读 值 的 


ES 


HB. X 
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件 BleCharacteristic.java 的 主要 实现 代码 如 下 。 


public class BleCharacteristic extends BleAttribute 
implements Parcelable 


1 
private static final String TAG — "BleCharacteristic"; 
private HashMap<BleGattID, BleDescriptor> ` mDescriptoerMap = new  HashMap-BleGattlID, 
BleDescriptor>(); 


private ArrayList<BleDescriptor> mDirtyDescQueue = new ArrayList<BleDescriptor>(); 
private int mProp; 
private int mWriteType; 
private byte mAuthReq; 
private int mPermission = 0; 
/** @hide */ 
@Suppress Warnings( ( 
"rawtypes", "unchecked" 


D 
public static final Parcelable.Creator<BleCharacteristic> CREATOR = new Parcelable.Creator() 
{ 

@Override 

public BleCharacteristic createFromParcel(Parcel source) { 

return new BleCharacteristic(source); 

} 

5 


/# 获 取 GATT 的 ID 值 */ 
private BleGattID getBleGattId(int handle) 


1 

for (Map.Entry<BleGattID, Integer entry : mHandleMap.entrySet()) { 

if (handle == entry.getValue().intValue()) { 
return entry.getKey(); 
j 

} 

return null; 
} 
A LE 


* 返 回 该 特征 的 实例 的 ID. 
* 实 例 ID 的 BLE 配置 文件 和 服务 用 于 标识 忆 


SCH 


于 一 个 给 定 的 实例 的 服务 或 轮廓 的 特征 


o 


public int getInstanceID() 


1 


return mID.getInstanceID(); 


[** 
* 指 定 一 个 实例 ID 的 这 一 特 怕 
* 
* @see {@link ZgetInstanceID()) 
E, 
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public void setInstanceID(int instanceID) 


1 


j 


[** 


mID.setInstanceld(instanceID); 


* 根 据 特性 向 一 个 给 定 的 偏 移 量 设置 原始 值 的 字 节 


«ii 


public byte setValue(byte[] value, int offset, int len, int handle, int totalsize, 


j 


String address) 


int uuid = -1; 
int uuidType = -1; 
Log.e("BleCharacteristic", "#### handle is "+ handle + " total size is " 
+ totalsize); 
BleGattID gattUuid — getBleGattId(handle); 
if (gattUuid == null) { 
Log.e("BleCharacteristic", "setValue: Invalid handle"); 
return BleConstants.GATT_INVALID HANDLE; 
} 
if (gattUuid.equals(mID)) { 
Log.i("BleCharacteristic", "## Writing a characteristic value.."); 
Log.i("BleCharacteristic", "##offset=" + offset + " mMaxLength-" 
+mMaxLength + " totalsize=" + totalsize); 
return setValue(value, offset, len, gattUuid, totalsize, address); 
} 
BleDescriptor descObj = mDescriptorMap.get(gattUuid); 
if (descObj != null) { 
Log.i("BleCharacteristic", Writing descriptor value.."); 
Log.i("BleCharacteristic", 


"##offset=" + offset + " mMaxSize=" + descObj.getMaxLength() + " totalsize=" 


+ totalsize + "desc uuid =" + descObj.getID()); 
if (offset > descObj.getMaxLength()) 
return BleConstants. GATT INVALID OFFSET; 
if (offset + totalsize > descObj.getMaxLength()) 
return BleConstants.GATT INVALID ATTR LEN; 
Log.i("BleCharacteristic", "find the user defined descriptor "); 
return descObj.setValue(value, offset, len, gattUuid, totalsize, address); 
} 
Log.e("BleCharacteristic", "Failed to write the value correctly!!!"); 
return -127; 


(8) 低 功 耗 描述 符 


在 Broadcom 公司 提供 的 源码 中 ， 文 伯 


定义 了 一 个 低 功 耗 描述 符 。 文 件 BleDescriptorjava 的 主要 实现 代码 如 下 。 


public class BleDescriptor extends BleAttribute 


F BleDescriptor.java 是 BleCharacteristic 的 一 部 分 ， 
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implements Parcelable 


private static final String TAG = "BleDescriptor"; 

private BleCharacteristic mCharObj; 

protected HashMap<String, Integer> mClientcfgMap = new HashMap(); 
/** @hide */ 


@Suppress Warnings( { 
"unchecked", "rawtypes" 
» 
public static final Parcelable.Creator<BleDescriptor> CREATOR = new Parcelable.Creator() 
1 
public BleDescriptor createFromParcel(Parcel source) { 
return new BleDescriptor(source); 
} 
public BleDescriptor[] newArray(int size) 
1 
return new BleDescriptor[size |]; 
j 
h 
[** 


* 从 一 个 给 定 的 偏 移 设 置 原始 值 的 字 节 的 描述 符 


* 


* @return {@link BleConstants?GATT SUCCESS if successful} 
2 
@Override 
public byte setValue(byte[] value, int offset, int length, BleGattID gattUuid, 
int totalSize, String address) 


int uuidType = gattUuid.getUuidType(); 
int uuid = -1; 
Log.e("BleDescriptor", "#### UUID type=" + gattUuid.getUuidType()); 

if (uuidType == 2) { 

uuid = gattUuid.getUuid16(); 
if (uuid == -1) { 
Log.e("BleDescriptor", "set Value: Invalid handle (UUID16 not found)"); 
return 1; 


if (uuid == 10500) { 
Log.i("BleDescriptor", "##Writing a Presentation format.."); 

} else if (uuid == 10498) { 
Log.i("BleDescriptor", "##Writing a characteristic client config"); 
if (totalSize > this. mMaxLength) 

return 13; 


int valueInt = 0; 
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for (int i = 0; i < length; i++) { 
int shift = (length - 1 - 1) * 8; 
valueInt += ((value[i] & OxFF) << shift); 
j 
this.mClientcfgMap.put(address, Integer.valueOf(valueInt)); 
} else if (gattUuid.equals(this.mID)) { 
Log.1("BleDescriptor", "##Writing a descriptor value.."); 
Log.i("BleDescriptor", "##offset="+ offset + " mMaxLength-" + this:mMaxLength 
+" Jength="+ length); 
super.set Value(value, offset, length, gattUuid, totalSize, address); 
j 
this.mDirty = true; 
return 0; 


(9) 标识 低 功 耗 蓝牙 规范 、 服 务 和 特性 

在 Broadcom 公司 提供 的 源码 中 ， 文 件 BleGattID java 定义 了 一 个 标识 低 功 耗 赣 牙 规 范 、 
服务 和 特性 的 类 ， 此 类 使 用 16 位 或 128 位 的 UUD 来 标识 一 个 给 定 的 低 功 耗 蓝牙 实体 ， 这 个 
实体 包含 规范 、 服 务 和 特性 。 文 件 BleGattID java 的 主要 实现 代码 如 下 。 


JS 
* 标 识 一 个 蓝牙 GATT 特性 或 
i 
public final class BleGattID extends BluetoothGattID 
implements Parcelable 


Hl 


性 


private static final String BASE UUID TPL = "94508x-0000-1000-8000-00805f9b34fb"; 
@Suppress Warnings( { 
"rawtypes", "unchecked" 
D 
public static final Parcelable.Creator<BleGattID> CREATOR = new Parcelable.Creator() { 
public BleGattID createFromParcel(Parcel source) { 
int instId — source.readInt(); 
int type = source.readInt(); 
int serviceType = source.readInt(); 
if (type == 16) { 
String sUuid = source.readString(); 
return new BleGattID(instId, sUuid, serviceType); 
j 
int uuid — source.readInt(); 
return new BleGattID(instId, uuid, serviceType); 
j 
public BleGattID[] newArray(int size) 


1 


return new BleGattID[size]; 
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} 
js 
(10) 为 远程 蓝牙 设备 提供 额外 信息 
TE Broadcom 公司 提供 的 源码 中 ,文件 BleAdapter.java 为 远程 蓝牙 设备 提供 了 额外 的 信息 ， 


TT 


BleAdapter.java 的 主要 实现 代码 如 下 。 


Je 


* 提 供 帮 助 的 功能 和 相关 的 常数 扩展 蓝牙 功能 的 低能 耗 信息 。 


T 


public class BleAdapter 


1 


private static final String TAG = "BleAdapter"; 
private static final boolean D = true; 

private static final int API LEVEL = 5; 
private static IBluetoothGatt mService; 

private GattServiceConnection mSvcConn; 
private Context mContext; 


[** 


* 设置 远程 ACTION FOUND 设备 的 额外 信息 


* @see {@link #DEVICE TYPE BREDR}, {@link #DEVICE TYPE BLE}, 
3 {@link #DEVICE_TYPE DUMO} 
Si 
public static final Sting EXTRA DEVICE TYPE ="android.bluetooth.device.extra. DEVICE TYPE"; 
public static final byte DEVICE TYPE BREDR = 1; 
public static final byte DEVICE TYPE BLE = 2; 
public static final byte DEVICE TYPE DUMO =3; 
public static final String ACTION UUID = "android.bluetooth.le.device.action. UUID"; 
public static final String EXTRA UUID = "android.bluetooth.le.device.extra. UUID"; 
public static final String EXTRA DEVICE - "android.bluetooth.le.device.extra.DEVICE"; 
private static boolean startService() ( 
if (mService != null) 
return true; 
[Binder service = ServiceManager.getService(BleConstants.BLUETOOTH LE SERVICE); 
if (service != null) 
mService = IBluetoothGatt.Stub.asInterface(service); 
return mService != null; 
j 
[** 
* 构建 一 种 新 的 BleAdapter 对 象 
E 
public BleAdapter(Context ctx) { 
this.mContext — ctx; 
if (startService()==false) 
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throw new RuntimeException("failed connecting to service"); 
this.init(); 


* 启动 远程 设备 中 的 蓝牙 服务 ， 发 现 使 用 {@link $ACTION  UUID) Im Ch 
E 
public static boolean getRemoteServices(String deviceAddress) 


1 
if (!startService()) 
throw new RuntimeException("service not available"); 
BluetoothAdapter adapter = BluetoothA dapter.getDefaultA dapter(); 
if (adapter == null) 
return false; 
try { 
mService.getUUIDs(deviceAddress); 
return true; 
} catch (RemoteException e) { 
e.printStackTrace(); 
if (D) 
Log.e(TAG, "error", e); 
} 
return false; 
j 


(11) 保存 和 GATT 相关 的 常量 
在 Broadcom 公司 提供 的 源码 中 , 文件 BleConstants.java 定义 保存 了 各 生 


[Z1 


FP 和 GATT 相关 的 


， 这 些 常 量 用 于 表示 各 种 和 实现 低 功 耗 功能 函数 的 属性 和 返回 值 。 文 件 BleConstants.java 


的 主 


要 实现 代码 如 下 。 


public abstract class BleConstants 


1 


public static final int GATT UNDEFINED - -1; 

public static final int GATT SERVICE CREATION SUCCESS - 0; 
public static final int GATT SERVICE CREATION FAILED - 1; 
public static final int GATT SERVICE START SUCCESS = 2; 
public static final int GATT SERVICE START FAILED = 3; 
public static final int GATT SERVICE STOPPED = 4; 

public static final int SERVICE UNAVAILABLE - 1; 

public static final int GATT SERVICE PRIMARY - 0; 

public static final int GATT SERVICE SECONDARY = 1; 

public static final int GATT SERVER PROFILE INITIALIZED = 0; 
public static final int GATT SERVER PROFILE UP - 1; 

public static final int GATT SERVER. PROFILE DOWN = 2; 
public static final int GATT SUCCESS - 0; 

public static final int GATT INVALID HANDLE - 1; 
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public static final int GATT READ NOT PERMIT = 2; 

public static final int GATT WRITE NOT PERMIT = 3; 

public static final int GATT INVALID PDU = 4; 

public static final int GATT INSUF AUTHENTICATION = 5; 
public static final int GATT REQ NOT SUPPORTED = 6; 
public static final int GATT INVALID OFFSET = 7; 

public static final int GATT INSUF AUTHORIZATION = 8; 
public static final int GATT_PREPARE Q FULL=9; 

public static final int GATT NOT FOUND = 10; 

public static final int GATT NOT LONG - 11; 

public static final int GATT INSUF KEY SIZE - 12; 

public static final int GATT INVALID ATTR LEN - 13; 

public static final int GATT ERR. UNLIKELY - 14; 

public static final int GATT INSUF ENCRYPTION - 15; 

public static final int GATT UNSUPPORT GRP TYPE - 16; 
public static final int GATT INSUF RESOURCE = 17; 

public static final int GATT ILLEGAL PARAMETER - 135; 
public static final int GATT NO RESOURCES - 128; 

public static final int GATT INTERNAL ERROR - 129; 

public static final int GATT WRONG STATE - 130; 

public static final int GATT DB FULL = 131; 

public static final int GATT BUSY = 132; 

public static final int GATT ERROR = 133; 

public static final int GATT CMD STARTED - 134; 

public static final int GATT PENDING = 136; 

public static final int GATT AUTH FAIL = 137; 

public static final int GATT MORE - 138; 

public static final int GATT INVALID CFG - 139; 

public static final byte GATT AUTH REQ NONE = 0; 

public static final byte GATT AUTH REQ NO MITM - 1; 
public static final byte GATT AUTH REQ MITM - 2; 

public static final byte GATT AUTH REQ SIGNED NO MITM =3; 
public static final byte GATT AUTH REQ SIGNED MITM - 4; 
public static final int GATT PERM READ = 1; 

public static final int GATT PERM READ ENCRYPTED - 2; 
public static final int GATT PERM READ ENC MITM - 4; 
public static final int GATT PERM WRITE - 16; 

public static final int GATT PERM WRITE ENCRYPTED - 32; 
public static final int GATT PERM WRITE ENC MITM - 64; 
public static final int GATT PERM WRITE SIGNED - 128; 
public static final int GATT PERM WRITE SIGNED MITM - 256; 
public static final byte GATT CHAR PROP BIT BROADCAST = 1; 
public static final byte GATT CHAR PROP BIT READ = 2; 
public static final byte GATT CHAR. PROP BIT WRITE NR = 4; 
public static final byte GATT CHAR. PROP BIT WRITE = 8; 
public static final byte GATT CHAR. PROP BIT NOTIFY = 16; 


274 BH 


WS 


第 9 章 开发 蓝牙 应 用 程序 


public static final byte GATT CHAR PROP BIT INDICATE = 32; 
public static final byte GATT CHAR PROP BIT AUTH = 64; 
public static final byte GATT CHAR PROP BIT EXT PROP = -128; 
public static final byte SVC INF INVALID = -1; 

public static final int GATTC_TYPE WRITE NO RSP- 1; 
public static final int GATTC TYPE WRITE - 2; 

public static final int GATT FORMAT RES = 0; 

public static final int GATT FORMAT BOOL- 1; 

public static final int GATT FORMAT 2BITS = 2; 

public static final int GATT FORMAT NIBBLE - 3; 

public static final int GATT FORMAT UINTS = 4; 

public static final int GATT FORMAT UINTI2 = 5; 

public static final int GATT FORMAT UINTI16 = 6; 

public static final int GATT FORMAT UINT24 - 7; 

public static final int GATT FORMAT UINT32 = 8; 

public static final int GATT FORMAT UINTAS - 9; 

public static final int GATT FORMAT UINT64 = 10; 
public static final int GATT FORMAT UINTI28 = 11; 
public static final int GATT FORMAT SINTS - 12; 

public static final int GATT FORMAT SINTI2 = 13; 
public static final int GATT FORMAT SINTI6 = 14; 
public static final int GATT FORMAT SINT24 = 15; 
public static final int GATT FORMAT SINT22 = 16; 
public static final int GATT FORMAT SINT48 = 17; 
public static final int GATT FORMAT SINT64 = 18; 
public static final int GATT FORMAT SINT128 = 19; 
public static final int GATT FORMAT FLOAT32 = 20; 
public static final int GATT FORMAT FLOAT64 = 21; 
public static final int GATT FORMAT SFLOAT = 22; 
public static final int GATT FORMAT FLOAT = 23; 
public static final int GATT FORMAT DUINT16 = 24; 
public static final int GATT FORMAT UTFSS = 25; 

public static final int GATT FORMAT UTF16S = 26; 
public static final int GATT FORMAT STRUCT = 27; 


码 中 的 注释 说 明 。 


9.4 


总 结 和 蓝牙 相关 的 类 


到 此 为 止 ，Broadcom 公司 推出 的 低 功 耗 蓝 牙 协 议 栈 BlueDroid 的 开发 文档 和 API 源码 分 
吉 束 。 本 书 只 是 分 析 了 主要 的 模块 类 ， 其 他 的 类 的 实现 代码 的 功能 和 原理 请 读者 参阅 其 源 


经 过 本 章 前 面 内 容 的 学 己 经 了 解 了 Android 系统 中 蓝牙 的 基本 知识 。 根 据 上 述 从 底 


层 到 应 用 的 学 习 ， 了 解 了 Android 蓝牙 系统 的 工作 原理 和 机 制 。 在 本 节 的 内 容 中 ， 将 详细 讲 
解 Android 蓝牙 系统 中 的 相关 知识 。 
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9.41 BluetoothSocket 类 
1. 定义 
类 BluetoothSocket 的 格式 如 下 。 


public static class Gallery.LayoutParams extends ViewGroup.LayoutParams 
类 BluetoothSocket 的 结构 如 下 。 


java.lang.Object 
android.view. ViewGroup.LayoutParams 
android.widget.Gallery.LayoutParams 


2. 公共 方法 
C1) public void close () 


功能 : 马上 关闭 该 端口 并 且 释 放 所 有 相关 的 资源 。 在 其 他 线程 的 该 端口 


而 使 系统 马上 抛 出 一 个 IO 异常 。 
异常 : IOException. 


(2) public void connect () 


功能 :尝试 连接 到 远程 设备 。 如 果 该 方法 没有 返回 异常 值 ， 则 表示 该 端口 已 经 建立 。 在 


中 引起 阻塞， 从 


蓝牙 适配器 中 ， 设 备 的 查找 工作 是 一 个 烦琐 的 过 程 ， 肯 定 会 降低 一 个 设备 的 连接 效率 。 此 外 


的 设备 查询 工作 并 不 是 由 活动 所 管理 的 ， 而 是 作为 一 个 系统 服务 来 运行 的 ， 所 以 有 
程序 也 总 会 调用 cancelDiscovery() 方 法 。close0 方 法 可 以 有 


直接 请 求 一 个 查询 ， 应 月 
另 一 线程 而 来 的 调用 。 
异常 : IOException， 表 示 一 个 错误 ， 例 如 连接 失败 。 
(3) public InputStream getInputStream () 


a 


NA EAS BE 


日 来 放弃 从 


功能 : 通过 连接 的 端口 获得 输入 数据 流 。 即 使 该 端口 未 连接 ， 也 会 返回 该 输入 的 数据 流 。 


不 过 在 该 数据 流 上 的 操作 将 抛 出 异常 ， 直 到 相关 的 连接 已 经 建立 为 目 。 


返回 值 : 输入 流 。 
异常 : IOException. 
(4) public OutputStream getOutputStream () 


功能 :通过 连接 的 端口 获得 输出 数据 流 。 即 使 该 端口 未 连接 ， 该 输 1 
不 过 在 该 数据 流 上 的 操作 将 抛 出 异常 ， 直 到 相关 的 连接 已 经 建 


返回 值 ， 输 出 流 。 
异常 : IOException。 


(5) public BluetoothDevice getRemoteDevice () 
功能 : 获得 该 端口 正在 连接 或 者 已 经 连接 的 远程 设备 。 
返回 值 : 远程 设备 。 
9.4.2 BluetoothServerSocket 类 
1. 定义 
类 BluetoothServerSocket 的 格式 如 下 。 
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public final class BluetoothServerSocket extends Object implements Closeable 
类 BluetoothServerSocket 的 结构 如 下 。 


java.lang.Object 
android.bluetooth.BluetoothServerSocket 


2. 公共 方法 

(1) public BluetoothSocketaccept (int timeout) 

功能 : 阻塞 直到 在 超时 时 间 内 连接 建立 。 在 一 个 成 功 建 立 的 连接 上 返回 一 个 已 连接 的 
BluetoothSocket 类 。 每 当 返 回 该 调用 的 时 候 ， 它 可 以 再 使 调用 去 接收 以 后 新 来 的 连接 。 同 样 ， 
close0 方 法 可 以 用 来 放弃 从 另 一 线程 来 的 调用 。 

参数 timeout: 表示 阻塞 超时 时 间 。 

返回 值 : 已 连接 的 BluetoothSocket。 
异常 : IOException， 表 示 出 现 错误 ， 比 如 该 调用 被 放弃 或 超时 。 
(2) public void close () 
功能 : 马上 关闭 端口 ， 并 释放 所 有 相关 的 资源 。 在 其 他 线程 的 该 端口 中 引起 阻塞 ， 从 而 
使 系统 马上 抛 出 一 个 IO 异常 。 关 闭 BluetoothServerSocket， 不 会 关闭 接受 自 acceptO 的 任意 


BluetoothSocket. 
异常 : IOException. 


0.4.3 BluetoothAdapter 类 
1. 定义 
类 BluetoothAdapter 的 格式 如 下 。 


public final class BluetoothAdapter extends Object 
类 BluetoothAdapter 的 结构 如 下 。 


java.lang.Object 
android.bluetooth.BluetoothA dapter 


注意 : 大 部 分 方法 需要 BLUETOOTH 权限 ， 还 有 一 些 方法 同时 需要 BLUETOOTH 
ADMIN 权限 。 

2. 常量 

(1) String ACTION DISCOVERY FINISHED 
广播 事件 : 本 地 蓝牙 适配器 已 经 完成 设备 的 搜寻 过 程 。 需 要 BLUETOOTH 权限 来 接收 。 
常量 值 : android.bluetooth.adapteraction.DISCOVERY FINISHED. 
(2) String ACTION DISCOVERY STARTED 
广播 事件 : 本 地 蓝牙 适配器 已 经 开始 了 对 远程 设备 的 搜寻 过 程 。 它 通常 涉及 到 一 个 大 概 
12 秒 的 查询 扫描 过 程 ， 紧 跟着 是 一 个 对 每 个 获取 到 的 蓝牙 名 称 的 新 设备 的 页 面 扫 描 。 用 户 会 
发 现 一 个 把 ACTION_FOUND 常量 通知 为 远程 蓝牙 设备 的 注册 。 


Li 


常量 值 : android.bluetooth.adapter.action. DISCOVERY STARTED. 
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(3) String ACTION LOCAL NAME CHANGED 


广播 活动 : 本 地 蓝牙 适配器 已 经 更 改 了 它 的 蓝牙 名 称 。 该 名 称 对 远程 蓝牙 设备 是 可 见 
的 , 它 总 是 包含 了 一 个 带 有 名 称 的 EXTRA LOCAL NAME 附加 域 。 需 要 BLUETOOTH 权限 


来 接收 。 


常量 值 : android.bluetooth.adapteraction.LOCAL NAME CHANGED" 


(4) String ACTION REQUEST DISCOVERABLE 


Activity 活动 : 显示 一 个 请 求 被 搜寻 模式 的 系统 活动 。 如 果 未 打开 当前 蓝牙 模块 ， 该 活动 


将 请 求 用 户 打开 蓝牙 模块 , 被 搜寻 模式 和 SCAN MODE CONNEC 


TABLE DISCOVERABLE 等 


价 。 当 远程 设备 执行 查找 进程 的 时 候 , 它 允 许 其 发 现 该 蓝牙 适配器 。 从 隐私 安全 考虑 , Android 


不 会 将 被 搜寻 模式 设置 为 默认 状态 。 


Android 运用 回收 方法 onActivityResult(int, int, Intent) 来 传递 该 活动 结果 的 通知 。 被 搜寻 


的 时 间 ( 以 秒 为 单位 ) 将 通过 resultCode 值 来 显示 。 如 果 用 户 提 
错误 ， 则 通过 RESULT CANCELED 值 来 显示 。 


当 扫 描 模 式 变化 时 ， 应 用 程序 可 以 通过 ACTION SCAN MODE CHANGED 值 来 监听 全 


E 绝 被 搜寻 ， 或 者 设备 产生 了 


局 的 消息 通知 。 比 如 ， 当 设备 停止 被 搜寻 以 后 ， 该 消息 可 以 被 系统 通知 给 应 用 程序 。 需 要 


BLUETOOTH 权限 。 


常量 值 : android.bluetooth.adapter.action REQUEST DISCOVERABLE 


(5) String ACTION REQUEST ENABLE 


Activity 活动 : 显示 一 个 允许 用 户 打 开 蓝 牙 模块 的 系统 活动 。 当 打开 蓝牙 模块 后 ， 或 者 当 


用 户 决定 不 打开 蓝牙 模块 时 ,系统 活动 将 返回 该 值 .Android 运用 


回收 方法 onActivityResult(int, 


int, Intent) 来 传递 该 活动 结果 的 通知 。 如 果 蓝 牙 模块 被 打开 , 将 通过 resultCode 值 RESULT. OK 


来 显示 。 如 果 用 户 拒绝 该 请 求 ， 或 者 设备 产生 了 错误 ， 则 通过 RESULT CANCELED 值 来 显 


示 。 每 当 蓝 牙 模块 被 打开 或 者 关闭 时 ， 应 用 程序 可 以 通过 ACTION STATE CHANGED 值 来 


监听 全 局 的 消息 通知 。 需 要 BLUETOOTH 权限 。 


常量 值 : android.bluetooth.adapteractionREQUEST ENABLE. 


(6) String ACTION SCAN MODE CHANGED 


广播 活动 :指明 蓝牙 扫描 模块 或 者 本 地 适配器 已 经 发 生变 化 , 它 总 是 包含 EXTRA_SCAN - 
MODE 和 EXTRA PREVIOUS SCAN _ MODE。 这 两 个 附加 域 各 自 包含 了 新 的 和 旧 的 扫描 模 


式 。 需 要 BLUETOOTH 权限 


常量 值 : android.bluetooth.adapteraction.SCAN_MODE CHANGED. 


(7) String ACTION STATE CHANGED 


广播 活动 : 本 来 的 蓝牙 适配器 的 状态 已 经 改变 ， 例 如 蓝牙 模块 已 经 被 打开 或 者 关闭 。 它 


总 是 包含 EXTRA_STATE il EXTRA PREVIOUS _ STATE。 这 两 个 附加 域 各 自 包含 了 新 的 和 | 


的 状态 。 需 要 BLUETOOTH 权限 接收 


mM 


常量 值 : android.bluetooth.adapter.action.STATE_CHANGED. 


(8) int ERROR 


功能 : 标记 该 类 的 错误 值 。 确 保 和 该 类 中 的 任意 其 他 整数 常量 不 相等 。 它 为 需要 一 个 标 


记 错 误 值 的 函数 提供 了 便利 。 例 如 : 
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Intent.getIntExtra(BluetoothAdapter.EXTRA STATE, BluetoothAdapter.ERROR) 


销量 值 : -2147483648 (0x80000000) 

(9) String EXTRA DISCOVERABLE DURATION 

HAE: ARIE ACTION. REQUEST. DISCOVERABLE 常量 中 作为 一 个 可 选 的 整 型 附加 域 ， 
来 为 短 时 间 内 的 设备 发 现 请 求 一 个 特定 的 持续 时 间 。 默 认 值 为 120 秒 ， 超 过 300 秒 的 请 求 将 
被 限制 。 这 些 值 是 可 以 变化 的 。 

常量 值 : android.bluetooth.adapter.extra.DISCOVERABLE DURATION. 

(10) String EXTRA LOCAL NAME 

功能 : 试图 在 ACTION LOCAL NAME CHANGED 常量 中 作为 一 个 字符 串 附 加 域 ， 来 
请 求 本 地 蓝牙 的 名 称 。 

常量 值 : android.bluetooth.adapter.extra.LOCAL NAME. 

(11) String EXTRA PREVIOUS SCAN MODE 

功能 : 试图 在 ACTION SCAN MODE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 求 
以 前 的 扫描 模式 。 可 能 的 取 值 如 下 。 

口 SCAN MODE NONE. 

D SCAN MODE CONNECTABLE. 

D SCAN MODE CONNECTABLE DISCOVERABLE. 

常量 值 : android.bluetooth.adapter.extra. PREVIOUS SCAN MODE. 

(12) String EXTRA PREVIOUS STATE 

功能 : 试图 在 ACTION STATE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 求 以 前 的 
供电 状态 。 可 能 的 取 值 如 下 。 

口 STATE OFF. 

D) STATE TURNING ON. 

O STATE ON. 

口 STATE TURNING OFF. 

常量 值 : android.bluetooth.adapter.extra.PREVIOUS STATE. 

(13) String EXTRA SCAN MODE 

功能 : 试图 在 ACTION SCAN MODE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 求 
当前 的 扫描 模式 。 可 能 的 取 值 如 下 。 

口 SCAN MODE NONE。 

D SCAN MODE CONNECTABLE。 

D SCAN MODE CONNECTABLE DISCOVERABLE. 

常量 值 : android.bluetooth.adapter.extra SCAN MODE. 

(14) String EXTRA STATE 

功能 : 试图 在 ACTION STATE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 求 当前 的 
供电 状态 。 可 能 的 取 值 如 下 。 

口 STATE OFF. 

D) STATE TURNING ON. 
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C] STATE ON. 

C] STATE TURNING OFF. 

wA: android.bluetooth.adapter.extra.STATE 。 

(15) int. SCAN MODE CONNECTABLE 

功能 : 指明 在 本 地 蓝牙 适配器 中 ， 碍 询 扫描 功能 失效 ， 但 页 面 扫描 功能 有 效 。 因 此 
该 设备 不 能 被 远程 蓝牙 设备 发 现 ， 但 如 果 以 前 曾经 发 现 过 该 设备 ， 则 远程 设备 可 以 对 其 
进行 连接 。 

常量 值 : 21 (0x00000015)。 

(16) int SCAN MODE CONNECTABLE DISCOVERABLE 

功能 : 指明 在 本 地 蓝牙 适配器 中 ， 查 询 扫描 功能 和 页 面 扫描 功能 都 有 效 。 因 此 该 设备 既 
可 以 被 远程 蓝牙 设备 发 现 ， 也 可 以 被 其 连接 。 

常量 值 : 23 (0x00000017)。 

(17) int SCAN MODE NONE 

功能 : 指明 在 本 地 蓝牙 适配器 中 ， 查 询 扫描 功能 和 页 面 扫描 功能 都 失效 。 因 此 该 设备 既 
不 可 以 被 远程 蓝牙 设备 发 现 ， 也 不 可 以 被 其 连接 。 

常量 值 : 20 (0x00000014)。 

(18) int STATE OFF 

功能 : 指明 本 地 蓝牙 适配器 模块 已 经 关闭 。 

常量 值 : 10 (0x0000000a)。 

(19) int STATE ON 
功能 : 指明 本 地 蓝牙 适配器 模块 已 经 打开 ， 并 且 准 备 被 使 用 。 
(20) int STATE TURNING OFF 
功能 : 指明 正在 关闭 本 地 蓝牙 适配器 模块 ， 本 地 客户 端 可 以 立刻 尝试 友好 地 断 ] 
外 部 连接 。 

常量 值 ，13 (0x0000000d). 

(21) int STATE TURNING ON 

功能 :指明 正在 打开 本 地 蓝牙 适配器 模块 ， 本 地 客户 在 尝试 使 用 这 个 适配器 之 前 需要 为 
STATE_ON 的 状态 而 等 待 。 

常量 值 : 11 (0x0000000b)。 

3. 公共 方法 

C12 public boolean cancelDiscovery () 
功能 : 取消 当前 的 设备 发 现 查 找 进程 ， 需 要 BLUETOOTH ADMIN 权限 。 因 为 对 蓝牙 适 
配器 而 言 ， 查 找 工作 需要 消耗 大 量 的 能 耗 ， 因 此 这 个 方法 必须 在 尝试 连接 到 远程 设备 前 使 用 
connect() 方 法 进行 调用 。 

返回 值 : 成功 则 返回 ttue， 有 错误 则 返回 false. 

(2) public static boolean checkBluetoothAddress (String address) 

功能 : 验证 蓝牙 地 址 ， 字 母 必须 为 大 写 才 有 效 。 

参数 address: 字符 串 形式 的 蓝牙 模块 地 址 。 

返回 值 : 地 址 正确 则 返回 true, UR [n] false. 
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(3) public boolean disable () 
关闭 本 地 蓝牙 适配器 ， 不 能 在 没有 明确 关闭 蓝牙 的 用 户 动作 中 使 用 。 没 有 用 户 的 


Tha 


He: 


直接 同 


变 系统 设置 的 用 户 界面 ， 例 如 “电源 控 表 


[i 


|” NH. 


9.44 BluetoothClass.Service 类 


类 BluetoothClass.Service 的 格式 如 下 。 


public static final class BluetoothClass.Service extends Object 


类 BluetoothClass.Service 的 结构 如 下 。 


Java.lang.Object 
android.bluetooth.BluetoothClass.Service 


类 BluetoothClass.Service 用 于 定义 所 有 的 服务 类 常量 , 任意 的 
服务 类 编码 组 成 。 在 类 BluetoothClass.Service 中 包含 了 如 下 的 常量 。 

ü int AUDIO. 

L] int CAPTURE. 

ü int INFORMATION. 

LI int LIMITED DISCOVERABILITY. 

ü int NETWORKING. 

QO) int OBJECT TRANSFER. 

LI int POSITIONING. 

LI int RENDER. 

L] int TELEPHONY. 
9.4.5 BluetoothClass.Device.Major 类 

类 BluetoothClass.Device.Major 的 格式 如 下 。 


public static class BluetoothClass.Device.Major extends Object 


类 BluetoothClass.Device.Major 的 结构 如 下 。 


java.lang.Object 
android.bluetooth.BluetoothClass.Device.Major 


类 BluetoothClass.Device.Major 用 于 定义 所 有 的 主要 设备 类 常量 ， 


口 


Oooo 


int 
int 
int 
int 


int 


=i 


AUDIO_VIDEO. 
COMPUTER. 
HEALTH. 
IMAGING. 
MISC. 


意 ， 蓝 牙 永 远 不 能 被 禁止 。 这 个 disable0 方 法 只 提供 了 一 个 应 用 ,该 应 用 包含 了 一 个 改 


的 BluetoothClass 由 0 或 多 个 


各 个 常量 如 下 。 
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int NETWORKING. 

int PERIPHERAL. 

int PHONE. 

int TOY. 

int UNCATEGORIZED. 
D int WEARABLE. 


9.4.6 BluetoothClass.Device 类 
类 BluetoothClass.Device 的 格式 如 下 。 


DOOOO 


public final class BluetoothClass.Device extends Object 


类 BluetoothClass.Device 的 结构 如 下 。 


java.lang.Object 
android.bluetooth.BluetoothClass.Device 


类 BluetoothClass.Device 用 于 定义 所 有 的 设备 类 的 常量 ， 每 个 BluetoothClass 实现 了 两 种 
设备 类 型 的 编码 ， 分 别 是 主要 设备 和 次 要 设备 。 里 面 的 常量 分 别 代表 主要 设备 和 次 要 设备 ， 
其 中 BluetoothClass.Device.Major 的 常量 只 能 代表 主要 设备 类 。 

BluetoothClass.Device 有 一 个 内 部 类 ， 此 内 部 类 定义 了 所 有 的 主要 设备 类 常量 。 内 部 类 的 
定义 格式 如 下 。 


class BluetoothClass.Device.Major 


9.4.7 BluetoothClass 类 
1. 定义 
类 BluetoothClass 的 格式 如 下 。 


public final class BluetoothClass extends Object implements Parcelable 


类 BluetoothClass 的 结构 如 下 。 


java.lang.Object 
android.bluetooth.BluetoothClass 


类 BluetoothClass 代表 了 一 个 描述 了 设备 通用 特性 和 功能 的 蓝牙 类 。 比 如 一 个 蓝牙 类 会 指 
定 诸如 电话 、 计 算 机 或 耳机 的 通用 设备 类 型 ， 可 以 提供 诸如 音频 或 者 电话 的 服务 。 每 个 蓝牙 
类 都 由 0 个 或 更 多 的 服务 类 , 以 及 一 个 设备 类 组 成 。 设备 类 将 被 分 解 成 主要 和 较 小 的 设备 类 

使 用 getBluetoothClass0 方 法 可 以 获取 为 远程 设备 所 提供 的 类 。 

2. 内 部 类 

类 BluetoothClass 有 如 下 的 两 个 内 部 类 。 

(1) class BluetoothClass.Device: 用 于 定义 所 有 设备 类 的 常量 。 
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(2) class BluetoothClass.Service: 用 于 定义 所 有 服务 类 的 常量 。 


9.5 ”实战 演练 一 一 开发 一 个 监 牙 控制 | 器 


实例 为 在 Android 设备 中 开发 一 个 蓝牙 控制 器 ， 通 过 这 个 控制 器 可 以 实现 如 下 的 


+ 


客户 端 。 
服务 器 端 。 
OBEX 服务 器 。 


UU UUUOUU: 
+ 
= 
"i 
3 


题 A 的 源码 路 径 


实例 9-1 开发 一 个 Android 蓝牙 控制 器 daima\9\Activity01 


95.1 界面 布局 
本 实例 主 界面 布局 文件 main.xml， 其 主要 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="Vvertical" android:layout_width="fill_parent" 
android:layout_height="fill_parent" android:padding="10dip"> 
<Button android:layout_width="fill_parent" 


android:layout height-"wrap content" android:text="4J JT à Z^" 
android:onClick-"onEnableButtonClicked" /> 
«Button android:layout width-"fill parent" 
android:layout height-"wrap content" android:text="2¢ [4] V 7" 
android:onClick-"onDisableButtonClicked" /> 
«Button android:layout width-"fill parent" 
android:layout height-"wrap content" android:text=" 人 允许 搜索 " 
android:onClick-"onMakeDiscoverableButtonClicked" /> 
«Button android:layout width-"fill parent" 


android:layout height-"wrap content" android:text-" F 4538 zz" 
android:onClick-"onStartDiscoveryButtonClicked" /> 
«Button android:layout width-"fill parent" 
android:layout height-"wrap content" android:text=" 客 户 端 " 
android:onClick="onOpenClientSocketButtonClicked" /> 
«Button android:layout width-"fill parent" 
android:layout height-"wrap content" android:text=" 服 务 器 端 " 
android:onClick-"onOpenServerSocketButtonClicked" /> 
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«Button android:layout width-"fill parent" 
android:layout height-"wrap content" android:text="OBEX 服务 器 " 


android:onClick-"onOpenOBEXServerSocketButtonClicked" /> 


</LinearLayout> 


执行 之 后 的 界面 效果 如 图 9-5 所 示 。 


图 9-5 执行 效果 


服务 器 端的 界面 布局 文件 是 server_socket.xml， 主 要 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:orientation="Vvertical" android:layout_width="fill_parent" 

android:layout height-"fill parent" android:padding="10dip"> 

«Button android:layout width-"fill parent" 
android:layout height-"wrap content" android:tex 
android:onClick-"onButtonClicked" /> 

<ListView android:id="@-+id/android:list" android:layout width-"fill parent" 
android:layout height-"fill parent" /> 

</LinearLayout> 


其 他 几 个 界面 的 布局 文件 和 上 述 文件 类 似 ， 为 节省 本 书 篇 幅 ， 将 不 再 一 一 列 出 。 


^N 


—"Stop server" 


9.5.2. ”响应 单 击 按钮 
编写 主 界面 的 程序 文件 Activity01.java， 功 能 是 根据 用 户 单 击 屏幕 中 的 按钮 来 调用 对 应 的 
处 理 函 数 ， 例 如 单 击 “ 服 务 器 端 ” 按 钮 会 执行 函数 onOpenServerSocketButtonClicked(View 


view)。 文 件 Activity01.java 的 主要 实现 代码 如 下 。 


= 


public class Activity01 extends Activity 


{ 
/# 取得 默认 的 蓝牙 适配器 */ 
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private BluetoothAdapter bluetooth = BluetoothAdapter.getDefaultAdapter(); 
入 请求 打开 蓝牙 + 
private static final int REQUEST ENABLE= 0x1; 
P 请 求 能 够 被 搜索 */ 
private static final int REQUEST_DISCOVERABLE = 0x2; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedInstanceState) 


1 


super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 

j 

ELIT E 

public void onEnableButtonClicked(View view) 


1 


NET 
_bluetooth.enable(); 


} 
PRAM * 
public void onDisableButtonClicked(View view) 
{ 
_bluetooth.disable(); 
} 
mm 使 设备 能 够 被 搜索 */ 
public void onMakeDiscoverableButtonClicked(View view) 
1 
Intent enabler = new Intent(BluetoothAdapter. ACTION REQUEST DISCOVERABLE); 
startActivityForResult(enabler, REQUEST DISCOVERABLE); 
} 
* 开始 搜索 */ 
public void onStartDiscoveryButtonClicked(View view) 


{ 
Intent enabler = new Intent(this, DiscoveryActivity.class); 
startActivity(enabler); 

j 

LET ES 

public void onOpenClientSocketButtonClicked(View view) 

{ 
Intent enabler = new Intent(this, ClientSocketActivity.class); 
startActivity(enabler); 

} 


* 服务 端 */ 
public void onOpenServerSocketButtonClicked(View view) 


1 


Intent enabler — new Intent(this, ServerSocketA ctivity.class); 
startActivity(enabler); 
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} 
/* OBEX 服务 器 a 
public void onOpenOBEXServerSocketButtonClicked(View view) 


1 
Intent enabler = new Intent(this, OBEXActivity.class); 


startActivity(enabler); 
} 
9.5.3 ”和 指定 的 服务 器 建立 连接 
编写 程序 文件 ClientSocketActivity.java， 功 能 是 创建 一 个 Socket 连接 ， 以 便 和 指定 的 服 
务 器 建立 连接 。 文 件 ClientSocketActivity.java 的 主要 实现 代码 如 下 。 


public class ClientSocketActivity extends Activity 
1 

private static final String TAG = ClientSocketActivity.class.getSimpleName(); 

private static final int REQUEST DISCOVERY = 0x1;; 

private Handler handler = new Handler(); 

private BluetoothAdapter bluetooth = BluetoothAdapter.getDefaultAdapter(); 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
getWindow().setFlags(WindowManager.LayoutParams.FLAG_ BLUR. BEHIND, 
WindowManager.LayoutParams.FLAG BLUR. BEHIND); 
setContentView(R.layout.client_socket); 
if (! bluetooth.isEnabled()) { 

finish(); 
return; 

} 
Intent intent = new Intent(this, DiscoveryActivity.class); 
Im 提示 选择 一 个 要 连接 的 服务 器 */ 
Toast.makeText(this, "select device to connect", Toast. LENGTH_SHORT).show(); 
P 跳 转 到 搜索 的 蓝牙 设备 列表 区 ， 进 行 选择 */ 
startActivityForResult(intent, REQUEST DISCOVERY); 


ixi 


} 

Im 选择 了 服务 器 之 后 进行 连接 */ 

protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
if (requestCode != REQUEST_DISCOVERY) { 


return; 

} 

if (resultCode !=RESULT_OK) { 
return; 

} 


final BluetoothDevice device = data.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE); 
new Thread() { 


public void run() { 
E +) 
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connect(device); 
h 
} start(); 
j 
protected void connect(BluetoothDevice device) { 
BluetoothSocket socket — null; 
try { 
/创建 一 个 Socket 连接 : 只 需要 服务 器 在 注册 时 的 UUID 号 
socket = device.createRfcommSocketToServiceRecord(UUID.fromString("a60f35f0- 


b93a-11de-8a39-08002009c666")); 


/连接 
socket.connect(); 
} catch (IOException e) { 
Log.e(TAG, "", e); 
} finally { 
if (socket != null) { 
try { 
socket.close(); 
} catch (IOException e) { 
Log.e(TAG, "", e); 


9.5.4 ”搜索 附近 的 蓝牙 设备 


编写 程序 文件 DiscoveryActivityjava， 功 能 是 搜索 设备 附近 的 蓝牙 设备 ， 并 在 列表 中 显示 


搜索 到 的 蓝牙 设备 。 文 件 DiscoveryActivityjava 的 主要 实现 代码 如 下 。 


public class DiscoveryActivity extends ListActivity 


1 


private Handler handler = new Handler(); 
* 取得 默认 的 蓝牙 适配器 */ 
private BluetoothAdapter bluetooth = BluetoothAdapter.getDefaultAdapter(); 
mm 用 来 存储 搜索 到 的 蓝牙 设备 */ 
private List<BluetoothDevice> devices = new ArrayList<BluetoothDevice>(); 
* 是 否 完成 搜索 */ 
private volatile boolean  discoveryFinished; 
private Runnable discoveryWorkder = new Runnable() { 
public void run() 
1 
* 开始 搜索 */ 
_bluetooth.startDiscovery(); 
for (;3) 
{ 
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if ( discoveryFinished) 
{ 
break; 
j 
try 
{ 
Thread.sleep(100); 
j 
catch (InterruptedException e) ) 
j 
j 
5 
/* * 
* 接收 器 
* 当 搜 索 蓝 牙 设备 完成 时 调用 
E 


private BroadcastReceiver foundReceiver = new BroadcastReceiver() { 
public void onReceive(Context context, Intent intent) { 
/* 从 intent 中 取得 搜索 结果 数据 */ 
BluetoothDevice device = intent 
.getParcelableExtra(BluetoothDevice.EXTRA DEVICE); 
AME 将 结果 添加 到 列表 中 */ 
_devices.add(device); 
/* 显示 列表 */ 


showDevices(); 
} 
je 
private BroadcastReceiver discoveryReceiver = new BroadcastReceiver() { 
@Override 
public void onReceive(Context context, Intent intent) 
{ 
/* RE */ 
unregisterReceiver( foundReceiver); 
unregisterReceiver(this); 
_discoveryFinished = true; 
} 
D 
protected void onCreate(Bundle savedInstanceState) 
{ 


super.onCreate(savedInstanceState); 

getWindow().setFlags( WindowManager.LayoutParams.FLAG BLUR. BEHIND, Window 
Manager.LayoutParams.FLAG BLUR. BEHIND); 

setContentView(R.layout.discovery); 

P 如 果 蓝 牙 适配器 没有 打开 ， 则 结果 zi 

if (! bluetooth.isEnabled()) 

1 
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finish(); 
return; 
} 
Im 注册 接收 器 */ 
IntentFilter discoveryFilter = new IntentFilter(BluetoothAdapter. ACTION DISCOVERY _ 
FINISHED); 
registerReceiver(_discoveryReceiver, discoveryFilter); 
IntentFilter foundFilter = new IntentFilter(BluetoothDevice. ACTION FOUND); 
registerReceiver( foundReceiver, foundFilter); 
P* 显示 一 个 对 话 框 ,正在 搜索 蓝牙 设备 */ 
SamplesUtils.indeterminate(DiscoveryActivity.this, handler, "Scanning...' 
Workder, new OnDismissListener() { 
public void onDismiss(DialogInterface dialog) 


, discovery 


1 
for(; bluetooth.isDiscovering();) 
1 

. bluetooth.cancelDiscovery(); 

j 
. discoveryFinished = true; 

j 

}, true); 


j 
P* 显示 列表 */ 
protected void showDevices() 
1 
List<String> list = new ArrayList<String>(); 
for (int i = 0, size = _devices.size(); 1 < size; +i) 
{ 
StringBuilder b = new StringBuilder(); 
BluetoothDevice d = _devices.get(i); 
b.append(d.getAddress()); 
b.append(‘\n'); 
b.append(d.getName()); 
String s = b.toString(); 
list.add(s); 
} 
final Array Adapter<String> adapter = new ArrayAdapter<String>(this, android.R.layout. 
simple list item 1, list); 
_handler.post(new Runnable() { 
public void run() 
{ 
setListAdapter(adapter); 


It 
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protected void onListItemClick(ListView L View v, int position, long id) 


1 
Intent result = new Intent(); 
result.putExtra(BluetoothDevice.EXTRA DEVICE, devices.get(position)); 
setResult(RESULT OK, result); 
finish(); 

j 


j 


9.5.5 ”建立 和 0BEX 服务 器 的 数据 传输 

编写 程序 文件 OBEXActivityjava， 功 能 是 实现 与 OBEX 服务 器 的 数据 传输 。OBEX 全 称 
为 Object Exchange， 中 文 对 象 交 换 ， 所 以 称 之 为 对 象 交 换 协 议 。OBEX 协议 通过 使 用 “PUT” 
和 “GET” 命 令 实 现在 不 同 的 设备 、 不 同 的 平台 之 间 方 便 、 高 效 地 交换 信息 。 支 持 的 设备 广 
泛 ， 例 如 PC、PDA、 电 话 、 摄 像 头 、 自 动 答 录 机 、 计 算 器 、 数 据 采集 器 和 手表 等 。 文 件 
OBEXActivityjava 的 主要 实现 代码 如 下 。 


public class OBEXActivity extends Activity 

{ 
private static final String TAG = "@MainActivity"; 
private Handler handler = new Handler(); 
private BluetoothServerSocket server; 
private BluetoothSocket socket; 
private static final int OBEX CONNECT - 0x80; 
private static final int OBEX DISCONNECT = 0x81; 
private static final int OBEX PUT = 0x02; 
private static final int OBEX PUT END = 0x82; 
private static final int OBEX RESPONSE OK = 0xa0; 
private static final int OBEX RESPONSE CONTINUE - 0x90; 
private static final int BIT MASK = 0x000000ff; 

Thread t = new Thread() 


1 
public void run() 
{ 
try 
{ 


server = BluetoothA dapter.getDefaultAdapter().listenUsingRfcomm WithService 
Record("OBEX", null); 


new Thread() 
1 
public void run() 
1 
Log.d("@Rfcom", "begin close"); 
try 
1 


. Socket.close(); 
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} 
catch (IOException e) 
{ 
Log.e(TAG, "", e); 
} 
Log.d("@Rfcom", "end close"); 
h 
} start(); 
_socket = server.accept(); 
reader.start(); 
Log.d(TAG, "shutdown thread"); 
} 
catch (IOException e) 
1 
e.printStackTrace(); 
} 
h 
h 
Thread reader = new Thread() 
{ 
public void run() 
{ 
try 
{ 


Log.d(TAG, "getting inputstream"); 
InputStream inputStream =  socket.getInputStream(); 
OutputStream outputStream =  socket.getOutputStream(); 
Log.d(TAG, "got inputstream"); 
int read = -1; 
byte[] bytes = new byte[2048]; 
ByteArrayOutputStream baos = new ByteArrayOutputStream(bytes. length); 
while ((read = inputStream.read(bytes)) != -1) 
1 
baos.write(bytes, 0, read); 
byte[] req = baos.toByteArray(); 
int op = req(0] & BIT MASK; 
Log.d(TAG, "read:" + Arrays.toString(req)); 
Log.d(TAG, "op:" + Integer.toHexString(op)); 
switch (op) 
1 
case OBEX CONNECT: 
outputStream.write(new byte[] { (byte) OBEX RESPONSE OK, 0, 7, 16, 0, 4, 
05) 
break; 
case OBEX DISCONNECT: 
outputStream.write(new byte[] ( (byte) OBEX RESPONSE OK, 0, 3, 0 3); 
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break; 
case OBEX PUT: 
outputStream.write(new byte[] { (byte) OBEX RESPONSE _ 
CONTINUE, 0, 3, 0 }); 
break; 
case OBEX PUT END: 
outputStream.write(new byte[] ( (byte) OBEX RESPONSE _ 


OK, 0, 3, 0 3); 
break; 
default: 
outputStream.write(new byte[] { (byte) OBEX RESPONSE ` 
OK, 0, 3, 0 }); 
} 
Log.d(TAG, new String(baos.toByteArray(), "utf-8")); 
baos = new ByteArrayOutputStream(bytes. length); 
} 
Log.d(TAG, new String(baos.toByteArray(), "utf-8")); 
} 
catch (IOException e) 
1 
e.printStackTrace(); 
} 
D 
h 
private Thread put = new Thread() { 
public void run() 
1 
h 
h 
public void onCreate(Bundle savedInstanceState) 
1 


super.onCreate(savedInstanceState); 
setContentView(R.layout.obex_server_socket); 


t.start(); 


j 


protected void onActivityResult(int requestCode, int resultCode, Intent data) 


1 
Log.d(TAG, data.getData().toString()); 


switch (requestCode) 


{ 
case (1): 
if (resultCode == Activity.RESULT OK) 


Uri contactData = data.getData(); 
@Suppress Warnings("deprecation") 
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Cursor c = managedQuery(contactData, null, null, null, null); 
for (; c.moveToNext();) 
{ 
Log.d(TAG, "c 1--------------------------------------- Dye 
dump(c); 
Uri uri = Uri. withAppendedPath(data.getData(), ContactsContract. 
Contacts.Photo. CONTENT DIRECTORY); 
@SuppressWarnings("deprecation") 
Cursor c2 = managedQuery(uri, null, null, null, null); 
for (; c2.moveToNext();) 
1 
Log.d(TAG, "c2--------------------------------------- Mj: 
dump(c2); 


break; 


j 
9.5.6 ”实现 蓝牙 服务 器 端的 数据 处 理 
编写 文件 ServerSocketActivityjava， 功 能 是 实现 蓝牙 服务 器 端的 数据 处 理 ， 建 立 服 务 


和 客户 端的 连接 和 监听 工作 ， 其 中 的 监听 工作 和 停止 服务 器 工作 由 独立 的 函数 实现 。 文 作 


ServerSocketActivity.java 的 主要 实现 代码 如 下 。 


public class ServerSocketActivity extends ListActivity 

1 
p 一 些 第 量 ， 代 表 服 务 器 的 名 称 */ 
public static final String PROTOCOL SCHEME L2CAP = "btl2cap"; 
public static final String PROTOCOL SCHEME RFCOMM = "btspp"; 
public static final String PROTOCOL SCHEME BT OBEX = "btgoep"; 
public static final String PROTOCOL SCHEME TCP OBEX = "tcpobex"; 
private static final String TAG = ServerSocketActivity.class.getSimpleName(); 


private Handler handler = new Handler(); 
* 取得 默认 的 蓝牙 适配器 */ 
private BluetoothAdapter bluetooth = BluetoothAdapter.getDefaultAdapter(); 
* 蓝牙 服务 器 */ 
private BluetoothServerSocket serverSocket; 
[* 线程 监听 客户 端的 链接 */ 
private Thread _serverWorker = new Thread() { 


5E 


public void run() { 
listen(); 
5 
5 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


AQ DR urna 


or it 


TT 
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getWindow().setFlags(WindowManager.LayoutParams.FLAG BLUR. BEHIND, 
WindowManager.LayoutParams.FLAG BLUR. BEHIND); 
setContentView(R.layout.server socket); 
if (! bluetooth.isEnabled()) { 
finish(); 
return; 
j 
pe 开始 监听 a 
_serverWorker.start(); 


} 

protected void onDestroy() { 
super.onDestroy(); 
shutdownServer(); 

} 


protected void finalize() throws Throwable { 
super. finalize(); 
shutdownServer(); 
} 
/* 停止 服务 器 */ 
private void shutdownServer() { 
new Thread() { 
public void run() { 


_serverWorker.interrupt(); 
if (_serverSocket != null) { 
try { 


* 关闭 服务 器 * 

_serverSocket.close(); 
} catch (IOException e) { 

Log.e(TAG, "", e); 


} 
_serverSocket = null; 
} 
h 
} start(); 
} 
public void onButtonClicked(View view) { 
shutdownServer(); 
} 
protected void listen() { 
try { 
/* 创建 一 个 蓝牙 服务 器 
* 参数 分 别 ， 服 务 器 名 称 、UUID 
Wi 
 serverSocket— bluetooth.listenUsingRfcommWithServiceRecordPROTOCOL SCHEME ` 
RFCOMM, 


UUID.fromString("a60f35f0-b93a-1 1de-8a39-08002009c666")); 
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P 客户 端 连 线 列表 +) 
final List<String> lines = new ArrayList<String>(); 


_handler.post(new Runnable() { 


public void run() { 

lines.add("Rfcomm server started..."); 

ArrayAdapter<String> adapter = new ArrayAdapter<String>( 
ServerSocketActivity.this, 
android.R.layout.simple list item 1, lines); 

setListAdapter(adapter); 


D 
/* 接受 客户 端的 连接 请 求 */ 
BluetoothSocket socket = serverSocket.accept(); 
[* 处 理 请 求 内 容 */ 
if (socket != null) { 
InputStream inputStream = socket.getInputStream(); 


int read = -1; 
final byte[] bytes = new byte[2048]; 
for (; (read = inputStream.read(bytes)) > -1;) { 
final int count = read; 
_handler.post(new Runnable() { 
public void run() { 
StringBuilder b = new StringBuilder(); 
for (int i = 0; 1 < count; ++i) { 
if (17 0) { 
b.append(' '); 
j 
String s = Integer.toHexString(bytes[i] & OxFF); 
if (s.length() « 2) { 
b.append('0*); 
j 
b.append(s); 
j 
String s = b.toString(); 
lines.add(s); 
Array AdaptersString^ adapter = new ArrayAdapter<String>( 
ServerSocketA ctivity.this, 
android.R.layout.simple list item 1, lines); 
setListA dapter(adapter); 


35 


j 
} catch (IOException e) 1 
Log.e(TAG, "", e); 
} finally { 
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在 文件 AndroidManifest.xml 中 声明 对 蓝牙 设备 的 使 用 权限 ， 有 具体 代码 如 下 。 


” LU 


<uses-permission android:name="android.permission.BLUETOOTH" /> 
<uses-permission android:name-"android.permission.BLUETOOTH ADMIN" /> 
<uses-permission android:name="android.permission.READ_CONTACTS'/> 


到 此 为 止 ， 整 个 实例 全 部 实现 ， 本 实例 需要 在 机 器 上 进行 测试 。 
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Wi-Fi 是 一 种 可 以 将 个 人 计算 机 、 手 持 设备 〈 如 PDA、 手 机 ) 等 终端 以 无 线 的 方式 互相 
连接 的 技术 。Wi-Fi 是 一 个 无 线 网 路 通信 技术 的 品牌 ,由 Wi-Fi 联盟 CWi-Fi Alliance) 所 持 有 。 
目的 是 改善 基于 IEEE 802.11 标准 的 无 线 网 路 产品 之 间 的 互通 性 。 在 本 章 的 内 容 中 ， 将 简 
要 介绍 在 Android 平台 中 开发 Wi-Fi 相关 应 用 的 基本 知识 。 


10. SRE WF 系统 的 结构 


要 想 完 全 掌握 Wi-Fi 应 用 开发 技术 ， 需 要 从 底层 源码 的 分 析 开 始 ， 需 要 先 了 解 它 的 底层 
结构 。 在 本 节 的 内 容 中 ， 将 简要 讲解 Wi-Fi 系统 底层 结构 的 基本 知识 。 


10.1.1 Wi-Fi 概述 


在 Android 系统 中 存在 了 一 个 无 线 控制 模块 ， 打 开 方 式 是 依次 单 击 Menu- Settings > 
Wireless$networks— Wi-Fi settings 命令 ， 来 到 如 图 10-1 所 示 的 界面 。 


Mobile network settings 


Data enabled 
Enable data acce 


ver Mobile 


Data roaming 


nect to data services when 


Access Point Names 


Use only 2G networks 
Saves battery 


Network operators 
hoose a network operator 


图 10-1 Wi-Fi 控制 界面 


10.1.2 ”Wi-Fi 层次 结构 
Wi-Fi 系统 的 上 层 接口 包括 数据 部 分 和 控制 部 分 , 数据 部 分 通常 是 一 个 和 以 太 网 卡 类 似 的 
网 络 设备 ， 控 制 部 分 用 于 实现 接 入 点 操作 和 安全 验证 处 理 。 
在 软件 层 ，Wi-Fi 系统 包括 Linux 内 核 程 序 和 协议 ， 还 包括 本 地 部 分 、Java 框架 类 。Wi-Fi 
系统 向 Java 应 用 程序 层 提 供 了 控制 类 的 接口 。 
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Android 平台 中 Wi-Fi 系统 的 基本 层次 结构 如 图 10-2 所 示 。 


Wi-Fi 系统 的 管理 类 平台 API 


Android.net.wifi 


Android 系统 


Wi-Fi INI, Wi-Fi 适配器 
E. wpa supplicant 


硬件 和 驱动 


由 图 10-2 可 知 ，Android 的 Wi-Fi 系统 从 上 到 下 主要 包括 Java 框架 类 、Android 适配器 
库 、wpa_supplicant 守护 进程 、 驱 动 程序 和 协议 ， 这 几 部 分 的 系统 结构 如 图 10-3 所 示 。 


Java 应 用 层 Settings, Wifitcher 等 
Java 框架 层 Android.net.wifi 包 


图 10-2 Wi-Fi 系统 的 层次 结构 


CERE 


内 核 空间 层 


图 10-3 Wi-Fi 的 系统 结构 
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#108 开发 Wi-Fi 应 用 程序 


在 开 


发 Android 网 络 应 用 程序 时 ， 


需要 使 用 图 10-3 中 的 框架 层 提供 的 接口 


来 实现 Wi-Fi 


通信 功能 。 其 中 最 主要 的 接口 有 三 类 ,分 别 是 WiFiManger、WifiService 和 WifiWatchdogService。 


在 本 节 的 内 容 中 ， 
10.2.1 WifiManger 接口 


将 详细 讲解 这 三 类 Wi-Fi 接口 的 基本 知识 。 


昌 户 通过 它 来 访问 Wi-Fi 的 核心 功能 。 


WifiManger 为 Wi-Fi 与 外 界 的 接口 ， 月 
WifiWatchdogService 这 一 系统 组 件 也 是 通过 WifiManger 来 执行 一 些 具 体操 作 。 
在 应 用 层 开发 Wi-Fi 程序 ,其 实 就 是 使 用 类 WifiManager 来 开发 应 用 程序 。 在 


了 监控 Wi-Fi 状态 的 方法 ， 其 状态 


口 WifiManager.WIFI STATE DISABLING: 表示 Wi-Fi 正在 关 
QO WifiManager.WIFI STATE DISABLED: 表示 Wi-Fi 已 经 关闭 。 
C) WifiManager WIFI STATE ENABLING: 表示 Wi-Fi 正在 打 
CQ) WifiManager WIFI STATE ENABLED: 表示 Wi-Fi 已 经 打开 。 


主要 有 如 下 5 种 。 


QO WifiManager.WIFI STATE UNKNOWN: 表示 Wi-Fi 无 法 识别 。 


A 


^: 


Ok ERU 


AA — 


四 个 。 


C] CHANGE NETWORK STATE:， 人 允许 修改 网 络 状态 的 权限 。 
口 CHANGE WIFI STATE: 
C] ACCESS NETWORK STATE: 允许 访问 网 络 状态 的 权限 。 


CQ) ACCESS WIFI STATE: 


10.22 WiliService 接口 


WifiService 是 服务 器 端的 实现 ， 作 为 Wi-Fi 的 核心 ， 
屋 上 报 的 事件 处 理 。 
用 相应 的 WifiNative 底层 来 实 ] 
一 般 会 将 其 转换 成 对 应 的 自身 消息 塞 入 消息 
FP 处 理 对 应 的 消息 。 
E. WifiStateTracker 和 


断 开 等 操作 ， 以 及 底 
对 来 自 客户 端的 控制 命令 ， 调 
当 接收 到 客户 端的 命令 后 ， 


户 端的 调用 可 以 及 时 返 


上 报 的 事件 ，WifiService 则 通 


WifiMonitor 的 具体 功能 如 下 。 


O WifiStateTracker: 除了 负责 Wi-Fi DI 


轮 询 机 制 ， 
通过 开启 一 


所 实现 的 事件 
LI WifiMonitor: 
面 提 到 的 


的 Handler 通知 给 WifiStateTracker。 这 里 
能 识别 的 消息 


WifiStateTracker Pf 
handleMessage() Hi 


允许 修改 Wi-Fi 状态 的 权限 。 


允许 访问 Wi-Fi 状态 的 权限 。 


主动 的 命令 控制 
SR 


对 于 


返回 ， 然 后 在 WifiHandler 的 handleMessage()4 


处 理 实际 的 驱动 加 载 、 扫 描 、 
，Wi-Fi 是 一 个 简单 上 


过 启动 WifiStateTracker 来 负责 处 到 


# 源 管理 模式 等 


以 及 消息 处 理 函 数 handleMessage(). 
一 个 MonitorThread 来 实现 事件 的 轮 询 ， 轮 询 的 关键 函数 是 前 


此 类 中 提供 


BE 


队列 中 ， 


中 声明 一 些 相关 的 权限 ， 和 Wi-Fi 权限 相关 的 操作 权限 主要 有 如 下 


链接 、 
BH, EF 


H 


而 底层 


功能 外 ,其 核心 部 分 是 WifiMonitor 


塞 式 函数 WifiNative.waitForEvent()。 获 取 事 件 后 ，WifiMonitor 通过 一 系列 


! WifiMonitor 的 通知 机 制 是 将 底 
JE A. WifiStateTracker 的 消息 循环 中 ， 
WifiStateTracker 完成 对 应 的 处 理 。 


4l 


= 
ZS 


事件 转换 成 
最 终 在 
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WifiStateTracker 也 是 Wi-Fi 与 外 


界 的 接口 , 它 不 像 WifiManger 那样 直接 被 实例 化 来 操作 ， 


而 是 通过 Intent 机 制 来 发 消息 通知 给 在 客户 端 注册 的 BroadcastReceiver, 以 完成 和 客户 端 


的 接口 。 
10.2.3 WiiiWatchdogService 接口 


WifiWatchdogService 是 ConnectivityService 所 启动 的 服务 ， 但 它 并 不 是 通过 Binder 来 实 


现 的 服务 。 它 的 作用 是 监控 同一 个 网 


络 内 的 接 入 点 (Access Point)， 如 果 当 前 接 入 点 的 DNS 


无 法 探测 通过 ping 命令 实现 ) 通 ， 


就 自动 切换 到 下 一 个 接 入 点 。WifiWatchdogService 通过 


WifiManger 和 WifiStateTracker 辅助 完成 具体 的 控制 动作 。 在 WifiWatchdogService 初始 化 时 ， 


通过 registerForWifiBroadcasts it Jl 


上 获取 网 络 变化 的 BroadcastReceiver ， 也 就 是 捕获 


WifiStateTracker 所 发 出 的 通知 消息 ， 


m 


F 


启 一 个 WifiWatchdogThread 线程 来 处 理 获取 的 消息 。 


通过 更 改 Setting Secure. WIFI WARCHDOG ON 的 配置 ， 可 以 开启 和 关闭 WifiWatchdog 


Service. 


10.2.4 实战 演练 一 一 在 Android 


系统 中 控制 Wi-Fi 


TÉ f Wi-Fi 的 基本 知识 后 , 接 下 来 将 通过 一 个 具体 实例 的 实现 过 程 ,详细 讲解 在 Android 


系统 中 开发 Wi-Fi 应 用 程序 的 基本 流程 ,在 本 实例 中 新 建 了 一 个 Android 应 用 程序 ,在 main.xml 
中 添加 8 个 按钮 ， 单 击 这 8 个 按钮 可 以 分 别 控制 手机 中 的 Wi-Fi， 本 实例 几乎 涵盖 了 现实 应 用 
中 所 有 的 Wi-Fi 控制 功能 。 


题 H 的 源码 路 径 
实例 10-1 控制 Wi-Fi daima\10\Wifiguan 


本 实例 的 具体 实现 流程 如 下 。 
C1) 编写 界面 布局 文件 main.xml， 具 体 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:orientation="Vertical" 


android:layout_width="fill_parent" 


android:layout height-"fill parent" 


> 


<TextView 


android:layout_width="fill_parent" 


android:layout height-"wrap content" 


android:text="@string/hello" 
J= 


<Button 


android:id="@+id/startButton" 
android:layout_width="300dp" 
android:layout_height="wrap_content" 


android:text="4J FF Wi-Fi 网 
[>> 
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(2) 编写 文件 Main java, 获取 屏幕 中 的 按钮 单 击 焦 点 , ARH 
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<Button 
android:id="(@+d/stopButton" 
android:layout_width="300dp" 
android:layout_height="wrap_content" 
android:text-" & 4] Wi-Fi 网 卡 " 
[^ 
«Button 
android:id="(@+id/checkButton" 
android:layout_width="300dp" 
android:layout_height="wrap_content" 
android:text-"f5 £t Wi-Fi 网 卡 状态 " 
/> 


</LinearLayout> 


和 的 按钮 实现 对 应 的 功能 。 


-= 


文件 Main java 的 主要 实现 代码 如 下 。 


public class Main extends Activity implements OnClickListener { 

/ 右 侧 滚动 条 按钮 

private ScrollView sView; 

private Button openNetCard; 

private Button closeNetCard; 

private Button checkNetCardState; 

private Button scan; 

private Button getScanResult; 

private Button connect; 

private Button disconnect; 

private Button checkNetWorkState; 

private TextView scanResult; 

private String mScanResult; 

private WifiAdmin mWifiAdmin; 

/** Called when the activity is first created. */ 

@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
mWifiAdmin = new WifiAdmin(Main.this); 


init(); 
} 
[** 
* 按钮 等 控件 的 初始 化 
E 


public void init() { 
sView = (ScrollView) find ViewByld(R.id.mScroll View); 
openNetCard = (Button) find ViewByld(R.id.openNetCard); 
closeNetCard = (Button) find ViewByld(R.id.closeNetCard); 
checkNetCardState = (Button) findViewByld(R.id.checkNetCardS tate); 
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scan = (Button) findViewByld(R.id.scan); 

getScanResult = (Button) find ViewByld(R.id.getScanResult); 

scanResult = (TextView) find ViewById(R.id.scanResult); 

connect = (Button) find ViewByld(R.id.connect); 

disconnect = (Button) find ViewByld(R.id.disconnect); 
checkNetWorkState = (Button) find ViewByld(R.id.checkNetWorkState); 


openNetCard.setOnClickListener(Main.this); 
closeNetCard.setOnClickListener(Main.this); 
checkNetCardState.setOnClickListener(Main.this); 
scan.setOnClickListener(Main.this); 
getScanResult.setOnClickListener(Main.this); 
connect.setOnClickListener(Main.this); 
disconnect.setOnClickListener(Main.this); 
checkNetWorkState.setOnClickListener(Main.this); 
} 
[** 
* WIFI STATE DISABLING 0 WIFI STATE DISABLED 1 WIFI STATE ENABLING 2 
* WIFI STATE ENABLED 3 
n 
public void openNetCard() ( 
mWifiAdmin.openNetCard(); 
j 
public void closeNetCard() ( 
mWifiAdmin.closeNetCard(); 
} 
public void checkNetCardState() { 
mWifiAdmin.checkNetCardState(); 


j 

public void scan() ( 
mWifiAdmin.scan(); 

} 


public void getScanResult() { 
mScanResult =mWifiAdmin.getScanResult(); 
scanResult.setText(mScanResult); 


} 
public void connect() { 

mWifiAdmin.connect(); 

startActivity(new Intent(android.provider.Settings. ACTION WIFI SETTINGS)); 
} 


public void disconnect() { 
mWifiAdmin.disconnectWifi(); 

} 

public void checkNetWorkState() { 
mWifiAdmin.checkNetWorkState(); 
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@Override 
public void onClick(View v) { 

switch (v.getId()) { 

case R.id.openNetCard: 
openNetCard(); 
break; 

case R.id.closeNetCard: 
closeNetCard(); 
break; 

case R.id.checkNetCardState: 
checkNetCardState(); 
break; 

case R.id.scan: 
scan(); 
break; 

case R.id.getScanResult: 
getScanResult(); 
break; 

case R.id.connect: 
connect(); 
break; 

case R.id.disconnect: 
disconnect(); 
break; 

case R.id.checkNetWorkState: 
checkNetWorkState(); 
break; 

default: 
break; 


} 
(3) 将 对 Wi-Fi 的 相关 操作 都 封装 在 类 WifiAdmin 中 ， 以 后 开启 或 关闭 等 相关 操作 可 以 
直接 调用 这 个 类 的 相关 方法 。 类 WifiAdmin 在 文件 WifiAdmin.java 中 定义 ， 主 要 实现 代 
码 如 下 。 


public class WifiAdmin { 
private final static String TAG = "WifiAdmin"; 
private StringBuffer mStringBuffer = new StringBuffer(); 
private List<ScanResult> listResult; 
private ScanResult mScanResult; 
// 定义 WifiManager 对 象 
private WifiManager mWifiManager; 
/ 定义 Wifilnfo 对 象 
private Wifilnfo mWifiInfo; 
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// 网 络 连接 列表 
private List<WifiConfiguration> mWifiConfiguration; 
// 定义 一 个 WifiLock 
WifiLock mWifiLock; 
[** 
* 构造 方法 
wi 
public WifiAdmin(Context context) { 
mWifiManager — (WifiManager) context 
.getSystemService(Context. WIFI SERVICE); 
mWifilnfo = mWifiManager.getConnectionInfo(); 


j 

[** 
* 打开 Wifi 网 卡 
*/ 


public void openNetCard() { 
if (ImWifiManager.isWifiEnabled()) { 
mWifiManager.setWifiEnabled(true); 


} 
} 
[** 
* 关闭 Wifi 网 卡 
*/ 


public void closeNetCard() { 
if (mWifiManager.isWifiEnabled()) { 
mWifiManager.setWifiEnabled(false); 


} 
} 
[** 
* 检查 当前 Wifi 网 卡 状 态 
*/ 


public void checkNetCardState() { 

if (mWifiManager.getWifiState()- — 0) { 
Log.i(TAG, "网 卡 正在 关闭 "); 

} else if (mWifiManager.getWifiState()== 1) ( 
Log.i(TAG, "网 卡 已 经 关闭 "); 

} else if (mWifiManager.getWifiState()== 2) { 
Log.i(TAG, "网 卡 正在 打开 "); 

} else if (mWifiManager.getWifiState()- — 3) { 
Log.i(TAG, "网 卡 已 经 打开 "); 

} else ( 
Log.i(TAG, "--_---%..... BARRARA ur 


* 扫描 周边 网 络 
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H 
public void scan() { 

mWifiManager.startScan(); 

listResult = mWifiManager.getScanResults(); 

if (listResult != null) { 
Log.i(TAG, "当前 区 域 存在 无 线 网 络 ， 请 查看 扫描 结 采 '); 

} else { 
Log.i(TAG, "当前 区 域 没 有 无 线 网 络 "); 


* 得 到 扫描 结果 
"0 
public String getScanResult() { 
/ 每 次 点 击 扫描 之 前 清空 上 一 次 的 扫描 结果 
if (mStringBuffer != null) { 
mStringBuffer = new StringBuffer(); 


} 
/ 开始 扫描 网 络 
scan(); 


listResult = mWifiManager.getScanResults(); 
if (listResult != null) { 
for (int 1 = 0; i < listResult.size(); i++) { 
mScanResult = listResult.get(i); 
mStringBuffer = mStringBuffer.append("NO.").append(i + 1) 
.append(" :").append(mScanResult.SSID).append("->") 
.append(mScanResult.BSSID).append("->") 
.append(mScanResult.capabilities).append("->") 
.-append(mScanResult.frequency).append("->") 
.-append(mScanResult.level).append("->") 
.append(mScanResult.describeContents()).append( nn"); 


j 
Log.1(TAG, mStringBuffer.toString()); 


return mStringBuffer.toString(); 


} 

pe 

* 连接 指定 网 络 
ét 


public void connect() { 
mWifilnfo = mWifiManager.getConnectionInfo(); 


} 
[pe 
* 断 开 当前 连接 的 网 络 


public void disconnectWifi() { 
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int netId = getNetworklId(); 
mWifiManager.disableNetwork(netld); 
mWifiManager.disconnect(); 
mWifiInfo = null; 

} 


[** 


* 检查 当前 网 络 状态 
* 
* @return String 
Ea 
public void checkNetWorkState() { 
if (mWifilnfo != null) { 
Log.i(TAG, "网 络 正常 工作 "); 
} else { 
Log.i(TAG, "网 络 已 断 开 "); 


} 
[** 
* 得 到 连接 的 ID 
e 
public int getNetworkId() { 
return (mWifiInfo == null) ? 0 : mWifilnfo.getNetworkId(); 
} 
[** 
* 得 到 卫 地 址 
public int getIPAddress() { 
return (mWifiInfo == null) ? 0 : mWifiInfo.getIpA ddress(); 
} 
// 锁定 WifiLock 
public void acquireWifiLock() { 
mWifiLock.acquire(); 
} 
// 解锁 WifiLock 
public void releaseWifiLock() { 
/ 判断 时 候 锁 定 
if (mWifiLock.isHeld()) { 
mWifiLock.acquire(); 


} 
/ 创建 一 个 WifiLock 
public void creatWifiLock() { 
mWifiLock = mWifiManager.createWifiLock("Test"); 
j 
/ 得 到 配置 好 的 网 络 


306 HH 


第 10 章 


public List<WifiConfiguration> getConfiguration() { 
return mWifiConfiguration; 

} 

// 指定 配置 好 的 网 络 进行 连接 

public void connectConfiguration(int index) { 
/ 索引 大 于 配置 好 的 网 络 索引 返回 
if (index >= mWifiConfiguration.size()) { 

return; 


} 
/ 连接 配置 好 的 指定 ID 的 网 络 


开发 Wi-Fi 应 用 程序 


mWifiManager.enableNetwork(mWifiConfiguration.get(index).networklId, 


true); 
} 
/ 得 到 MAC 地 址 
public String getMacAddress() { 


return (mWifiInfo == null) ? "NULL" : mWifilnfo.getMacAddress(); 


} 
/ 得 到 接 入 点 的 BSSID 
public String getBSSID() { 


return (mWifiInfo == null) ? "NULL" : mWifilnfo.getBSSID(); 


} 
// 得 到 Wifilnfo 的 所 有 信息 包 
public String getWifiInfo() { 


return (mWifiInfo == null) ? "NULL" : mWifiInfo.toString(); 


} 
/ 添加 一 个 网 络 并 连接 
public int addNetwork(WifiConfiguration weg) { 


int wegID = mWifiManager.addNetwork(mWifiConfiguration.get(3)); 


mWifiManager.enableNetwork(wcgID, true); 
return wegID; 


} 


(4) 在 文件 AndroidManifest.xml 中 声明 Wi-Fi 权限 ， 有 具体 代码 如 下 。 


<!-- 以 下 是 使 用 wifi 访问 网 络 所 需 的 权限 --> 


<uses-permission android:name="android.permission. CHANGE NETWORK. STATE"></uses-permission> 
<uses-permission android:name-"android.permission. CHANGE WIFI STATE"></uses-permission> 


<uses-permission 


android:name="android.permission. ACCESS NETWORK_STATE"></uses-permission> 
<uses-permission android:name="android.permission. ACCESS WIFI STATE"></uses-permission> 


到 此 为 止 ， 整 个 实例 介绍 完毕 ， 执 行 之 后 的 效果 如 图 1074 所 示 。 


本 实例 和 本 章 上 一 个 实例 相 比 ， 最 大 的 升级 是 增加 了 “ 扫 


果 ” 按 钮 后 ， 会 显示 扫描 到 的 Wi-Fi 源 ， 如 图 10-5 所 示 。 


描 结 果 ” 功 


DE, fur "idi 
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m wi 
打开 无 线 网 卡 ”关闭 无 线 网 卡 


i 
m 
"s 
状 


扫描 网 络 ”扫描 结果 


连接 Wifi ” 断 开 Wifi ”Wifi 连 接 状 态 


图 10-4 执行 效果 图 10-5 “显示 扫描 结果 


$B: 在 本 实例 中 ， 连 接 Wi-Fi 是 比较 复杂 的 ， 这 需要 在 程序 中 进行 连接 ， 此 时 会 有 如 
下 两 种 可 能 情况 。 

(1) Wi-Fi 没有 密码 ， 可 以 直接 连接 。 

(2) Wi-Fi 有 密码 ， 在 程序 中 给 出 密码 ， 然 后 连接 。 

最 简单 的 解决 方案 是 直接 让 程序 跳 到 系统 设置 的 Wi-Fi 的 页 面 ， 然 后 手动 去 设置 。 其 实 
Android 版 的 QQ 就 是 这 么 做 的 。 
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半导体 〈 现 为 因 智 浦 半导体 )、 诺 基 亚 和 索尼 共同 研制 


主动 和 被 动 两 种 读 取 模式 。 在 本 章 的 内 容 中 ， 将 详细 讲解 在 Android 设备 


术 的 基本 知识 


1.1 近 场 通信 技术 基础 


NFC 近 场 通信 技术 是 由 RFID 及 互联 互通 技术 整合 演变 而 来 ， 在 单一 芯片 上 结合 感应 式 


读 卡 器 、 感 应 式 卡 片 和 点 对 点 的 功能 ， 能 在 短 距 离 内 与 兼容 设备 进行 识别 和 数据 交换 。 工 作 
晶 是 使 用 这 种 技术 进行 手机 支付 的 用 户 必须 更 换 特制 的 手机 。 目 前 这 项 技 


频率 为 13.56MHz, 


术 在 日 韩 被 广泛 应 用 。 手 机 用 户 凭借 配置 了 支付 功能 的 手机 就 可 以 行 壳 全 国 : 
以 用 作 机 场 登 机 验证 、 大 厦 的 门禁 钥匙 、 交 通 一 卡通 、 信 用 卡 、 文 付 卡 等 。 在 本 节 的 内 容 中 ， 
将 简要 讲解 NFC 技术 的 基本 知识 。 


11.1.1 NFC 技术 的 特点 


NFC 是 基于 RFID 技术 发 展 起 来 的 一 种 近 距 离 无 线 通 信 技 术 。 与 RFID 一 样 ， 近 场 通 
信人 信息 也 是 通过 频谱 中 无 线 频 率 部 分 的 电磁 感应 耦合 方式 进行 传递 ， 但 两 者 之 间 还 是 存 
在 很 大 的 区 别 。 近 场 通信 的 传输 范围 比 RFID ^, RFID 的 传输 范围 为 orte T 由 于 近 


耗 低 等 特点 。 


场 通信 采取 了 独特 的 信号 衰减 技术 ， 相 对 于 RFID 来 说 近 场 通信 有 具有 成 本 低 、 


在 现实 应 用 中 ， 近 场 通信 技术 的 主要 特征 如 下 。 
OQ 用 于 近 距 离 (10cm UA) 安全 通信 的 无 线 通信 技术 。 


口 射频 频率 : 
口 ax, 


13.56MHz. 
ISO 14443, ISO 15693, Felica 标准 。 


O 数据 传输 速度 : lO6Kbit/s, 212 Kbit/s, 424Kbit/s. 


11.1.2 NEC 的 工作 模式 


在 现实 应 用 中 ，NFC 技术 有 如 下 的 三 种 工作 模式 。 


NFC 近 场 通信 技术 详解 


近 场 通信 (Near Field Communication, NFC) 技术 由 非 接 触 式 射 频 识 
ARTI, FA KU 
RFID 及 互 连 技术 。 


别 CRFIDO 演 


发 ， 其 基础 是 


MA A 


NFC 是 一 种 短 距 高 频 的 无 线 电 技 术 , 在 13.56MHz MWK, 运行 于 Se 
距离 内 。 其 传输 速度 有 106 Kbit/s, 212 Kbit/s 或 者 424 Kbit/s 三 种 。 目 前 近 
且 成 为 ISO/IEC IS 18092 国际 标准 、ECMA-340 标准 与 


场 通信 已 


ETSITS 102 190 标准 。NFC 
使 用 NEC dx 


他 们 的 手机 可 
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O FRI (Card emulation): 此 模式 其 实 就 是 相当 于 一 张 采用 RFID 技术 的 IC 卡 ， 可 以 


蔡 代 当 前 市 面 中 的 大 多 数 IC 卡 ， 例 如 场合 商场 居 
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公交 卡 、 门 禁 管 制 、 车 票 和 门 


票 等 。 卡 模式 有 一 个 极 大 的 优点 ， 那 就 是 卡片 通过 非 接触 读 卡 器 的 RF 域 来 供电 ， 即 


便 是 寄主 设备 〈 如 手机 ) 没 电 也 可 以 正常 工作 。 

口 点 对 点 模式 (P2P mode): 此 模式 和 红外 线 差不多 ， 
较 短 ， 但 是 传输 创建 速度 较 快 ， 传 输 速度 也 快 ， 
设备 连接 ， 能 实现 数据 的 点 对 点 传输 ， 如 下 载 音 乐 、 


LE 


服务 。 


可 用 于 数据 交换 ， 只 是 传输 距离 


且 功 耗 低 。 将 两 个 具备 NFC 功能 的 


交换 图 片 或 者 同步 设备 地 址 表 。 


因此 通过 NFC， 多 个 设备 如 数码 相机 、PDA、 计 算 机 和 手机 之 间 都 可 以 交换 资料 或 者 


O 读 卡 器 模式 (Reader/writer mode): 作为 非 接触 读 卡 器 使 用 ， 比 如 从 海报 或 者 展览 信 


县 电子 标签 上 读 取 相关 信息 。 


11.1.3 NFC 和 蓝牙 的 对 比 


在 现实 应 用 中 ，NFC 和 蓝牙 (Bluetooth) 都 是 短程 
中 。 但 NFC 不 需要 复杂 的 设置 程序 ， 简 单 性 的 甚至 可 以 j 
蓝牙 的 地 方 在 于 设置 程序 较 短 ， 但 无 法 达到 低 功 率 蓝 
速度 。 在 两 台 NFC 设备 的 相互 连接 并 识别 的 过 程 中 ， 
牙 连 接 方式 ， 会 至 少 块 十 分 之 一 秒 。 


E 


在 传输 速度 与 距离 比 不 上 蓝牙 ， 但 是 NFC 技术 不 需要 电源 ， 


通信 技术 ， 而 且 都 被 集成 到 手机 


国 越 于 蓝牙 连接 方式 。NFC 优 于 


(Bluetooth Low Energy) 的 传输 
接 速 度 会 快 于 依靠 人 工 设置 的 蓝 


NFC 的 最 大 数据 传输 量 是 424Kbit/s， 这 远 小 于 Bluetooth V2.1 (2.1 Mbit/s). Hi^ NFC 


对 于 手机 或 其 他 电子 产品 来 说 ， 
由 于 耗 电量 低 、 一 次 只 和 一 台 机 


NEC 的 使 用 比较 方便 。NFC 的 短 距离 通信 特性 正 是 其 优点 ， 


充 的 作用 


器 链接 ， 所 以 拥有 较 高 的 保密 性 与 安全 性 ，NFC 技术 用 于 信用 
NFC 的 目标 并 非 是 取代 蓝牙 等 其 他 无 线 技术 ， 而 是 在 不 同 的 场合 、 不 同 的 领域 能 起 到 相互 补 


交易 时 可 有 效 避 免 被 盗用 。 


NFC 技术 和 蓝牙 技术 相 比 ， 主 要 支持 的 功能 参数 如 表 11-1 所 示 。 


表 11-1 NFC 技术 和 蓝牙 技术 的 参数 对 比 


说 明 NFC Bluetooth Bluetooth Low Energy 
RFID 兼容 ISO 18000-3 active active 
标准 化 机 构 ISO/IEC Bluetooth SIG Bluetooth SIG 

网 络 标准 ISO 13157 ete. IEEE 802.15.1 IEEE 802.15.1 

网 络 类 型 Point-to-point WPAN WPAN 

加 密 not with RFID available available 
范围 < 0.2 m ~10 m (class 2) —] m (class 3) 
频率 13.56 MHz 2.4-2.5 GHz 2.4-2.5 GHz 
Bit rate 424 kbit/s 2.1 Mbit/s ~1.0 Mbit/s 
设置 程序 «0.1s «6s «1s 
THEE < 15mA (read) varies with class < 15 mA (xmit) 
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11.2 ”射频 识别 技术 详解 


射频 识别 (Radio Frequency Identification, RFID) 技术 ， 又 称 无 线 射 频 识 别 ， 是 NFC dx 
术 的 一 个 子 集 。RFID 是 一 种 通信 技术 ， 可 以 通过 无 线 电信 号 识别 特定 目标 并 读 写 相关 数据 ， 


而 无 需 识别 


系统 与 特定 目标 之 间 建 立 的 机 械 或 光学 接触 。 在 现实 中 常用 的 RFID 技术 有 低频 


(125KHz-134.2 KHz)、 高 频 (13.56MHz)、 超 高 频 ， 微 波 等 技术 。RFID 读 写 器 也 分 为 移动 式 
的 和 固定 式 的， 目前 RFID 
的 内 容 中 ， 将 详细 讲解 射频 识别 技术 RFID 的 基本 知识 。 


11.2.1 RFID 技术 简介 


技术 应 用 很 广 ， 如 图 书馆 、 门 禁 系 统 和 食品 安全 济源 等 。 在 本 节 


fi 


RFID 是 一 种 无 线 通 信 技 术 ， 可 以 通过 无 线 电信 和 号 识别 特定 目标 并 读 写 相关 数据 。 从 
概念 上 来 讲 ，RFID 类 似 于 条 码 扫 描 ， 对 于 条 码 技术 而 言 ， 它 是 将 已 编码 的 条 形 码 附着 于 
目标 物 , 并 使 用 专用 的 扫描 读 写 器 利用 光 信 和 号 将 信息 由 条 形 磁 传 送 到 扫描 读 写 器 ; 而 RFID 


则 使 用 专用 的 RFID 读 写 器 
SR. 


RFID 标签 传送 至 RFID 


及 专门 的 可 附着 于 目标 物 的 RFID 标签 ,利用 频率 信号 将 信息 


无 线 电 的 信号 是 通过 转 ] 


身 成 无 线 电 频率 的 电磁 场 , 把 附着 在 物品 标签 上 的 数据 传送 出 去 ， 


以 自动 辨识 与 追踪 该 物品 。 某 些 标签 在 识别 时 从 识别 器 发 出 的 电磁 场 中 就 可 以 得 到 能 量 ， 从 


而 不 需要 电池 ; 有 
人 磁场 )。 标 签 包 含 了 1 


的 标签 本 身 拥 有 电源 ， 并 可 以 主动 发 出 无 线 电 波 〔 转 换 成 无 线 电 频率 的 电 


外 子 存储 的 信息 ， 数 米 之 内 都 可 以 识别 。 与 条 形 码 不 同 的 是 ， 射 频 标签 不 


需要 处 在 识别 器 视线 之 内 ， 也 可 以 嵌入 在 物体 之 内 。 

在 现实 的 应 用 中 ， 有 许多 行业 都 运用 了 射频 识别 技术 。 将 标签 附着 在 一 辆 正在 生产 中 的 
汽车 ， 可 以 追踪 此 车 在 生产 线 上 的 进度 。 在 仓库 中 可 以 追踪 药品 的 所 在 。 射 频 标签 也 可 以 附 
于 牲畜 与 宠物 上 ， 方 便 对 牲畜 与 宠物 的 积极 识别 〈 积 极 识别 意思 是 防止 数 只 牲畜 使 用 同一 个 


身份 )。 射 频 识 别 的 身份 识别 卡 可 以 使 员工 得 以 进入 锁 住 的 建筑 场所 ， 汽 车 上 的 射频 应 答 器 也 


可 以 用 于 公路 和 停车 场 的 收费 。 
某 些 射频 标签 可 以 附 在 衣物 、 个 人 财物 上 ， 甚 至 植 入 人 体 之 内 。 由 于 可 能 会 在 未 经 本 人 
许可 的 情况 下 读 取 个 人 信息 ， 


11.2.2 RFID 技术 的 组 成 


这 项 技术 会 有 侵犯 个 人 隐私 忧患 。 


和 跟踪 物体 。 系 统 由 一 个 询问 器 和 多 个 应 答 器 组 成 。 在 最 初 的 技术 领域 中 ， 应 答 器 是 指 能 
传输 信息 、 回 复 信息 的 电子 模块 。 近 年 来 ， 由 于 射频 技术 发 展 迅猛 ， 应 答 器 有 了 新 的 说 法 和 
含义 ， 又 被 叫做 智能 标签 或 标签 。RFID 电子 标签 的 阅读 器 通过 天 线 与 RFID 电子 标签 进行 无 
线 通 信 ， 可 以 实现 对 标签 识别 码 和 内 存 数据 的 读 或 写 操作 。RFID 技术 可 识别 高 速 运动 的 物体 


从 结构 上 讲 RFID 是 


种 简单 的 无 线 系统 ， 只 有 两 个 基本 组 件 ， 该 系统 用 于 控制 、 检 测 


并 可 同时 识别 多 个 标签 ， 操 作 快 捷 方便 。 
RFID 的 具体 组 成 部 分 如 下 。 
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口 应 答 器 : 由 天 线 ， 耦 合 元 件 及 芯片 组 成 ， 一 般 来 说 都 是 用 标签 作为 应 答 器 ， 每 个 标签 


O 阅读 器 : 由 天 线 ， 耦 合 元 件 ， 


具有 唯一 的 电子 编码 ， 附 着 在 物体 上 用 于 标识 目标 对 象 。 


芯片 组 成 ， 读 取 《〈 有 时 还 可 以 写 入 ) 标签 信息 的 设备 ， 


可 设计 为 手持 式 RFID 读 写 器 (如 C5000W) 或 固定 式 读 写 器 。 


口 应 用 软件 系统 : 是 应 用 层 软件 ， 主 要 是 把 收集 的 数据 做 进一步 处 理 。 


11.2.3 RED 技术 的 特点 


射频 识别 系统 最 重要 的 优点 是 


ARRAN, EEFE, Fe. UK. GH. UTA 


形 码 无 法 被 使 用 的 恶劣 环境 阅读 标签 , 并 且 阅 读 速度 极 快 , 大 多 数 情况 下 不 到 100 毫秒 。 


Ee 


了 源 式 射 频 识 别 系统 的 速写 能 力也 是 重要 的 优点 。 可 用 于 流程 跟踪 和 维修 跟踪 等 交互 式 
业务 。 


制约 射频 识别 系统 发 展 的 主要 


问题 是 不 兼容 的 标准 。 射 频 识 别 系 统 的 主要 三 商 提供 


的 都 是 专 有 的 系统 ， 导 致 不 同 的 应 
种 混乱 和 人 割据 的 状况 已 经 制约 了 整 


这 个 问题 ， 并 已 经 取得 了 一 些 成 绩 
应 用 。 


大 幅 提 高 货物 信 , 


需求 信息 ， 以 优化 整个 供应 链 。 


RFID 技术 的 主要 特点 如 下 。 


用 和 不 同 的 行业 采用 不 同 厂商 的 频率 和 协议 标准 ， 这 
个 射频 识别 行业 的 增长 。 许 多 欧美 组 织 正在 着 手 解决 
。 标 准 化 必 将 刺激 射频 识别 技术 的 大 幅度 发 展 和 广泛 


O 快速 扫描 : RFID 辨识 器 可 以 同时 辨识 读 取 数 个 RFID 标签 。 
D 体积 小 型 化 、 形 状 多 样 化 : RFD 在 读 取 时 并 不 受 尺 寸 大 小 与 形状 限制 ， 不 需要 为 了 
读 取 的 精确 度 而 配合 适当 的 纸张 固定 尺寸 和 印刷 品质 。 此 外 ，RFID 标签 更 可 向 小 型 


化 与 多 样 形态 发 展 ， 以 应 用 于 不 同 产 品 。 
D 抗 污染 能 力 和 耐久 性 : 传统 条 形 码 的 载体 是 纸张 ， 因此 容易 受到 污染 , 但 RFID 对 


水 、 油 和 化 学 药品 等 物质 具 
外 包装 纸箱 上 ， 所 以 特别 容 
以 免 受 污 损 。 


OC 可 重复 使 用 : 条 形 码 被 印刷 到 附着 物 上 之 后 就 无 法 更 改 ，RFID 标签 则 可 以 重复 地 新 


有 很 强 的 抵抗 性 。 此 外 ， 由 于 条 形 码 是 附 于 塑料 袋 或 
易 受 到 折 损 ; RFID 卷 标 是 将 数据 存在 蕊 片 中 ， 因 此 可 


增 、 修 改 、 删 除 RFID 卷 标 内 储存 的 数据 ， 方 便 信息 的 更 新 。 
口 穿 透 性 和 无 屏障 阅读 : 在 被 覆盖 的 情况 下 ，RFID 能 够 穿 透 纸张 、 木 材 和 塑料 等 非 金 


属 或 非 透 明 的 材质 ， 并 能 够 进行 穿 透 性 通信 。 而 条 形 码 扫描 机 必须 在 近 距离 而 且 没 有 


物体 阻挡 的 情况 下 ， 才 可 以 


# 读 条 形 码 。 


口 数据 的 记忆 容量 大 : 一 维 条 形 码 的 容量 是 50B， 二 维 条 形 码 最 大 的 容量 可 储存 2B 一 


300B, RFID 最 大 的 容量 则 有 几 M。 随 着 记忆 载体 的 发 展 ， 数 据 容量 也 有 不 断 扩 大 的 
趋势 。 未 来 物品 携带 的 数据 量 会 越 来 越 大 ， 对 卷 标的 容量 需求 也 相应 增加 。 


口 安全 性 : 由 于 RFID 承载 的 是 电子 式 信 息 ， 其 数据 内 容 可 经 由 密码 保护 ， 使 其 内 容 不 


易 被 伪造 及 变更 。 


RFID 因 其 所 具备 的 远 距 离 读 取 、 高 储存 量 等 特性 而 备 受 瞩目 。 它 不 仅 可 以 帮助 一 个 企业 
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息 管 理 的 效率 ， 还 可 以 帮助 销售 企业 和 于 


J 造 企 业 互 联 ， 通 过 接收 反馈 信息 ， 


11.2.4 RFID 技术 的 工作 原理 


RFID 技术 的 基本 


A 
或 者 由 标签 主动 发 送 革 
并 解码 后 ， 送 至 中 央 信 


一 套 完整 的 RFID 系统 ， 是 由 阅读 器 与 


件 系 统 三 个 部 份 所 组 成 ， 


电流 所 获得 的 能 量 发 送 昌 
一 频率 上 


存储 在 蕊 片 
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作 原 理 是 : 当 标 签 进 入 磁场 后 ， 接 收 解读 器 发 出 的 射频 信号， 
的 产品 信息 (Passive Tag， 无 源 标 签 或 被 动 标 签 )， 

的 信号 (Active Tag， 有 源 标签 或 主动 标签 )， 解 读 器 读 取 信息 
Härr Cp Ak, 


TRA 


Ee pa eds 


凭借 感 


包子 标签 (TAG) 也 就 是 所 谓 的 应 答 器 及 应 用 软 


发 射 一 特定 频率 的 无 线 


昌 波 能 量 给 NES, 用 


以 驱动 应 答 器 电路 将 内 部 的 数据 送出 ， 此 时 阅读 器 便 依 序 接收 解读 数据 ， 送 给 应 用 程序 做 相 


应 的 处 理 。 


以 RFID 卡片 阅读 器 及 


DARNI 


子 标签 之 间 的 通 


e 


信 及 能 量 感 应 方式 来 


(Inductive Coupling) 及 后 向 散射 耦合 (BackscatterCoupling) 两 种 。 


HE rH, 


Ip 


FF. 在 实际 应 用 中 ， 可 进 


远程 传送 等 管理 功能 。 


应 答 器 是 RFID 系统 的 信 ， 
微 带 天 线 等 ) 和 微 芯 片 组 成 的 无 源 证 


元 。 


11.3 Android 系统 中 的 NFC 


NFC 通信 技术 


的 RFID 大 都 采用 第 一 种 方式 ， 而 较 高 频 大 多 采用 第 二 种 方式 。 
阅读 器 根据 使 用 的 结构 和 技术 不 同 可 以 分 为 读 或 读 / 写 装置 ， 是 RFID 系统 信息 控 伟 
阅读 器 通常 由 耦合 模块 、 收 发 模块 、 控 制 模块 和 接口 单元 组 成 。 
闻 一 般 采 用 半 双 工 通 信和 方式 进行 信息 交换 ， 同 时 阅读 器 通过 耦合 给 
步 通过 Ethernet 或 WLAN 等 实现 对 物体 识别 信 
息 载 体 ， 应 答 器 大 多 是 | 


区 分 , 可 以 大 致 上 ; 


源 应 答 器 提供 能 量 


RFID 
通常 低频 


I 和 处 
阅读 器 和 应 答 器 之 
量 和 时 
息 的 采集 、 处 理 及 
灯 合 原件 (线圈 、 


个 发 起 者 和 一 个 接收 者 组 成 ,通常 及 起 者 主动 发 送 电 磁场 为 被 


总 是 由 

动 式 接受 者 提供 电源 。 其 工作 的 基本 原理 和 收音 机 类 似 。 正 是 由 于 被 动 式 接受 者 可 以 通过 
发 起 者 提供 电源 ， 因 此 接收 可 以 是 非常 简单 的 形式 ， 比 如 标签 、 卡 和 Sticker 的 形式 。 男 
外 ,NFC 也 支持 点 到 点 的 通信 (peer to peer), 此 时 参与 通信 的 双方 都 有 电源 支持 。 在 Android 
系统 的 NEC 模块 应 用 中 ，Android 手机 通常 是 作为 通信 中 的 发 起 者 ， 也 就 是 作为 NFC 的 
读 写 器 。Android 手机 也 可 以 模拟 作为 NFC 通信 的 接收 者 ,并且 从 Android 2.3.3 起 也 支持 
点 对 点 通信 。Android 系统 支持 如 下 的 NFC 标准 。 

口 NfcANFC-A (ISO 14443-3A). 

口 NfcBNFC-B (ISO 14443-3B). 

Q NfcFNFC-F (JIS 6319-4). 

Q NfcVNFC-V (ISO 15693). 

QO) IsoDepISO-DEP (ISO 14443-4). 

QO) MifareClassic. 

LI MifareUltralight. 

在 Android 系统 中 ，NFC 模块 从 上 到 下 的 结构 如 图 11-1 所 示 。 


在 本 节 的 内 容 中 ， 将 详 
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fit Android 系统 中 NFC 模块 源码 的 基本 知识 
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android.nfc 标准 接 
标签 技术 


android.nfc.tech 


NFC 服务 相关 
底层 设备 接口 原型 
.NfcService NFC 服务 实现 DeviceHostListener #2 
com.android.nfc.dhimpl NFC 功能 底层 实现 -com.android.nfc.DeviceHost (NXP) 


implements DeviceHost 


com.android.nfc 


.DeviceHost 


.NativeNfcManager 
JNI-> com android nfc NativeNfcManager.cpp (libnfc jni.so) 
.NativeNfcSecureElement 

JNI-> com android nfc NativeNfcSecureElement.cpp (libnfc jni.so) 


libnfc-nxp => libnfc.so, libnfc ndef.so 


libnfc-nci => libnfc-nci.so 


图 11-1. NFC 模块 从 上 到 下 的 结构 


11.3.1. 分 析 Java Æ 


在 Android 系统 中 ，NFC 模块 的 Java 层 代码 位 于 如 下 的 目录 中 。 


\frameworks\base\core\java\android\nfc\ 


在 上 述 目 录 中 ,包含 了 用 来 与 本 地 NEC 适配器 进行 交互 的 顶层 类 ， 这 些 类 可 以 表示 被 检 


PP 的 数据 格式 )。 在 NFC DI Java eH, FF 


测 到 的 TAG 和 用 NDEF (NFC 组 织 约定 的 NEC tag 4 
用 的 顶层 类 如 下 。 
(1) NfcManager 


类 NfcManager 7E X fl Mrameworks base core java android nfeNfeManager.java 中 定义 ， 这 
是 一 个 NFC Adapter 的 管理 器 ， 可 以 列 出 所 有 此 Android 设备 中 被 支持 的 NFC Adapter, Hh 
过 大 部 分 Android 设备 只 有 一 个 NFC Adapter， 所 以 在 大 部 分 情况 下 可 以 直接 用 静态 方法 
getDefaultA dapter(context)2K bd Nos « XC f frameworks base core java android nfe| NfcManager. 


java 的 具体 实现 代码 如 下 。 


public final class NfcManager { 
private final NfcAdapter mAdapter; 
public NfcManager(Context context) { 
NfcAdapter adapter; 
context = context.getA pplicationContext(); 
if (context == null) { 
throw new IllegalArgumentException( 


"context not associated with any application (using a mock context?)"); 
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} 
try { 
adapter = NfcAdapter.getNfcA dapter(context); 
} catch (UnsupportedOperationException e) { 
adapter = null; 
} 
mAdapter = adapter; 


* 得 到 这 个 设备 的 默认 NEC 适配器 
* 
= 
public NfcAdapter getDefaultAdapter() { 
return mA dapter; 


j 


(2) NfcAdapter 

ZS dr X f'FXframeworks base core java android nfeNfcAdapterjava 中 定义 ， 此 类 表示 本 设备 
的 NFC Adapter, n] UE X. Intent 来 请 求 将 系统 检测 到 TAG 的 提醒 发 送 到 Activity， 并 提供 方 
法 去 注册 前 台 TAG 提醒 发 布 和 前 台 NDEF 推送 。 前 台 NDEF 推送 是 当前 Android 版 本 唯一 
支持 的 点 对 点 NFC 通信 方式 。 文 件 \frameworks\base\core\java\android\nfc\NfcAdapter.java DI H. 
体 实现 代码 如 下 。 


public final class NfcAdapter { 
static final String TAG = "NFC"; 
public static final String ACTION NDEF DISCOVERED = "android.nfc.action.NDEF ` 
DISCOVERED"; 
@SdkConstant(SdkConstantType.ACTIVITY INTENT ACTION) 
public static final String ACTION TECH DISCOVERED = "android.nfc.action. TECH _ 
DISCOVERED"; 
@SdkConstant(SdkConstantType.ACTIVITY INTENT ACTION) 
public static final String ACTION TAG DISCOVERED = "android.nfc.action. TAG ` 
DISCOVERED"; 
public static final String ACTION TAG LEFT FIELD = "android.nfc.action. TAG LOST"; 
public static final String EXTRA TAG = "android.nfc.extra. TAG"; 
public static final String EXTRA NDEF MESSAGES = "android.nfc.extra. NDEF MESSAGES"; 
public static final String EXTRA ID = "android.nfc.extra.ID"; 
@SdkConstant(SdkConstantType. BROADCAST INTENT ACTION) 
public static final String ACTION ADAPTER STATE CHANGED = 

"android.nfc.action. ADAPTER STATE CHANGED"; 

public static final String EXTRA ADAPTER STATE = "android.nfc.extra ADAPTER STATE"; 
public static final int STATE OFF - 1; 
public static final int STATE TURNING ON -2; 
public static final int STATE ON = 3; 
public static final int STATE TURNING OFF - 4; 
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public static final int FLAG NDEF PUSH NO CONFIRM = 0x1; 

public static final String ACTION HANDOVER TRANSFER STARTED = 
"android.nfc.action. HANDOVER TRANSFER STARTED"; 

public static final String ACTION HANDOVER TRANSFER DONE = 
"android.nfc.action. HANDOVER TRANSFER. DONE"; 

public static final String EXTRA HANDOVER TRANSFER STATUS = 
"android.nfc.extras HANDOVER TRANSFER. STATUS"; 

public static final int HANDOVER TRANSFER STATUS SUCCESS = 0; 

public static final int HANDOVER TRANSFER STATUS FAILURE = 1; 

public static final String EXTRA HANDOVER TRANSFER URI = 
"android.nfc.extra HANDOVER TRANSFER URI"; 

static boolean sIsInitialized = false; 


static INfcAdapter sService; 
static INfcTag sTagService; 
static HashMap<Context, NfcAdapter> sNfcAdapters = new HashMap(); 
static NfcAdapter sNullContextNfc Adapter; 
final NfcActivity Manager mNfcActivity Manager; 
final Context mContext; 
public interface OnNdefPushCompleteCallback { 
public void onNdefPushComplete(NfcEvent event); 
} 
public interface CreateNdefMessageCallback { 
public NdefMessage createNdefMessage(NfcEvent event); 
} 
public interface CreateBeamUrisCallback { 
public Uri[] createBeamUris(NfcEvent event); 
} 
private static boolean hasNfcFeature() { 
IPackageManager pm = ActivityThread.getPackageManager(); 
if (pm == null) { 
Log.e(TAG, "Cannot get package manager, assuming no NFC feature"); 
return false; 
} 
try 1 
return pm.hasSystemFeature(PackageManager.FEATURE NFC); 
} catch (RemoteException e) { 
Log.e(TAG, "Package manager query failed, assuming no NFC feature", e); 
return false; 


j 
public static synchronized NfcAdapter getNfcAdapter(Context context) ( 
if (!sIsInitialized) { 
PORTA NEC 装置 */ 
if (!hasNfcFeature()) { 
Log.v(TAG, "this device does not have NFC support"); 
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throw new UnsupportedOperationException(); 
} 
sService = getServicelnterface(); 
if (sService == null) { 
Log.e(TAG, "could not retrieve NFC service"); 
throw new UnsupportedOperationException(); 
j 


try { 
sTagService = sService.getNfc TagInterface(); 


} catch (RemoteException e) { 
Log.e(TAG, "could not retrieve NFC Tag service"); 
throw new UnsupportedOperationException(); 


j 


sIsInitialized — true; 
j 
if (context == null) { 
if (sNullContextNfcA dapter == null) { 
sNullContextNfcAdapter = new NfcAdapter(null); 


j 
return sNullContextNfc Adapter; 


} 
NfcAdapter adapter = sNfcAdapters.get(context); 
if (adapter == null) { 
adapter = new NfcAdapter(context); 
sNfcAdapters.put(context, adapter); 
} 
return adapter; 
} 
/** 获取 NFC 服务 接口 的 */ 
private static INfcAdapter getServiceInterface() { 


IBinder b = ServiceManager.getService("nfc"); 
if (b == null) { 
return null; 


j 
return INfcAdapter.Stub.asInterface(b); 


} 
public static NfcAdapter getDefaultAdapter(Context context) { 
if (context == null) { 
throw new IllegalArgumentException("context cannot be null"); 
} 
context = context.getApplicationContext(); 
if (context == null) { 
throw new IllegalArgumentException( 
"context not associated with any application (using a mock context?)"); 
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[* —SmuE */ 
NfcManager manager = (NfcManager) context.getSystemService(Context.NFC SERVICE); 
if (manager == null) { 


// NFC not available 
return null; 
} 
return manager.getDefaultAdapter(); 
} 
@Deprecated 


public static NfcAdapter getDefaultAdapter() { 
Log.w(TAG, "WARNING: NfcAdapter.getDefaultAdapter() is deprecated, use " + 
"NfcA dapter.getDefaultA dapter(Context) instead", new Exception()); 


return NfcAdapter.getNfcA dapter(null); 


j 
public boolean isEnabled() { 

try { 
return sService.getState()9- - STATE ON; 

} catch (RemoteException e) { 
attemptDeadServiceRecovery(e); 
return false; 

j 

j 
public int getAdapterState() { 

try { 
return sService.getState(); 

} catch (RemoteException e) 1 
attemptDeadServiceRecovery(e); 
return NfcAdapter. STATE OFF; 

} 

} 
public boolean enable() { 

try { 
return sService.enable(); 

} catch (RemoteException e) { 
attemptDeadServiceRecovery(e); 
return false; 

} 

} 
public boolean disable() { 
try { 


return sService.disable(true); 

} catch (RemoteException e) { 
attemptDeadServiceRecovery(e); 
return false; 
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} 
public void setBeamPushUris(Uri[] uris, Activity activity) { 


if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
j 
if (uris != null) { 
for (Uri uri : uris) ( 
if (uri == null) throw new NullPointerException("Uri not "+ 
"allowed to be null"); 
String scheme = uri.getScheme(); 
if (scheme == null || ('scheme.equalsIgnoreCase(" file") && 
!scheme.equalsIgnoreCase("content"))) { 
throw new IllegalArgumentException("URI needs to have "+ 
"either scheme file or scheme content"); 


j 
mNfcActivityManager.setNdefPushContentUri(activity, uris); 


j 
public void setBeamPushUrisCallback(CreateBeamUrisCallback callback, Activity activity) { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 


} 
mNfcActivityManager.setNdefPushContentUriCallback(activity, callback); 
j 
public void setNdefPushMessage(NdefMessage message, Activity activity, 
Activity ... activities) ( 
int targetSdk Version = getSdkVersion(); 
try { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
j 
mNfcActivityManager.setNdefPushMessage(activity, message, 0); 
for (Activity a : activities) { 
if (a == null) { 
throw new NullPointerException("activities cannot contain null"); 
j 
mNfcActivityManager.setNdefPushMessage(a, message, 0); 


j 
} catch (IllegalStateException e) { 
if (targetSdk Version < android.os.Build. VERSION CODES JELLY BEAN) { 
Log.e(TAG, "Cannot call API with Activity that has already " + 
"been destroyed", e); 


} else ( 
// Prevent new applications from making this mistake, re-throw 
throw(e); 
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} 
public void setNdefPushMessage(NdefMessage message, Activity activity, int flags) { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 


} 
mNfcActivity Manager.setNdefPushMessage(activity, message, flags); 


j 
public void setNdefPushMessageCallback(CreateNdefMessageCallback callback, Activity activity, 
Activity ... activities) ( 
int targetSdk Version = getSdkVersion(); 
try { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
} 
mNfcActivityManager.setNdefPushMessageCallback(activity, callback, 0); 
for (Activity a: activities) { 
if (a == null) { 
throw new NullPointerException("activities cannot contain null"); 


j 


mNfcActivityManager.setNdefPushMessageCallback(a, callback, 0); 


j 


} catch (IllegalStateException e) { 
if (targetSdk Version < android.os.Build. VERSION CODESJELLY BEAN) { 
Log.e(TAG, "Cannot call API with Activity that has already " + 
"been destroyed", e); 


} else { 
throw(e); 
j 
j 
j 
public void setNdefPushMessageCallback(CreateNdefMessageCallback callback, Activity activity, 
int flags) { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
} 
mNfcActivityManager.setNdefPushMessageCallback(activity, callback, flags); 
j 


public void setOnNdefPushCompleteCallback(OnNdefPushCompleteCallback callback, 
Activity activity, Activity ... activities) { 
int targetSdk Version = getSdkVersion(); 
try { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
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mNfcActivityManager.setOnNdefPushCompleteCallback(activity, callback); 
for (Activity a : activities) { 


} 


if (a == null) { 
throw new NullPointerException("activities cannot contain null"); 


} 
mNfcActivityManager.setOnNdefPushCompleteCallback(a, callback); 


} catch (IllegalStateException e) { 
if (targetSdk Version < android.os.Build. VERSION CODES JELLY BEAN) { 


Log.e(TAG, "Cannot call API with Activity that has already " + 
"been destroyed", e); 


} else ( 


j 


public void e 


throw(e); 


nableForegroundDispatch(Activity activity, PendingIntent intent, 


IntentFilter[] filters, String[][] techLists) { 
if (activity == null || intent == null) { 
throw new NullPointerException(); 


} 


if (lactivity.isResumed()) { 


} 
try { 
Te 


throw new IllegalStateException("Foreground dispatch can only be enabled " + 


"when your activity is resumed"); 


chListParcel parcel = null; 


if (techLists !— null && techLists.length > 0) { 


j 


parcel = new TechListParcel(techLists); 


Activity Thread.currentA ctivityThread().registerOnActivityPausedL istener(activity, 


mForegroundDispatchListener); 


sService.setForegroundDispatch(intent, filters, parcel); 


} catch 


(RemoteException e) { 


attemptDeadServiceRecovery(e); 


} 


public void disableForegroundDispatch(Activity activity) { 
ActivityThread.currentActivity Thread().unregisterOnActivityPausedListener(activity, 


disable 
} 


mForegroundDispatchListener); 
ForegroundDispatchInternal(activity, false); 


(3) NdefMessage 和 NdefRecord 


NDEF 是 NFC 2425 


URL 和 


定义 的 数据 结构 ， 用 来 将 有 效 的 数据 存储 到 NFC TAG 中 ， 比 如 文本 、 


titt, MIME 类 型 


H. —"^* NdefMessage 扮演 一 个 容器 , 这 个 容器 存储 发 送 和 读 到 的 数据 。 
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一 个 NdefMessage 对 象 包含 0 或 多 个 NdefRecord, 每 个 NDEF record 有 一 个 类 型 ， 比 如 文本 ， 
URL， 智 慧 型 海报 /广告 ， 或 其 他 MIME 数据 。 在 NDEFMessage 中 的 第 一 个 NfcRecord 的 类 
型 ， 功 能 是 发 送 TAG 到 一 个 Android 设备 上 的 Activity。 其 中 类 NdefMessage 在 文 们 
\frameworks\base\core\java\android\nfc\NdefMessage.java 中 定义 ， 具 体 实 现代 码 如 下 。 


FE 


public final class NdefMessage implements Parcelable { 

private final NdefRecord[] mRecords; 

public NdefMessage(byte[] data) throws FormatException { 
if (data == null) throw new NullPointerException("data is null"); 
ByteBuffer buffer = ByteBuffer.wrap(data); 
mRecords = NdefRecord.parse(buffer, false); 
if (buffer.remaining() > 0) { 

throw new FormatException("trailing data"); 


j 
public NdefMessage(NdefRecord record, NdefRecord ... records) { 
/ 验证 
if (record == null) throw new NullPointerException("record cannot be null"); 
for (NdefRecord r : records) { 
if (r == null) { 
throw new NullPointerException("record cannot be null"); 


} 

mRecords = new NdefRecord[1 + records. length]; 

mRecords[0] = record; 

System.arraycopy(records, 0, mRecords, 1, records.length); 
} 
public NdefMessage(NdefRecord[] records) { 

/ 验证 

if (records.length < 1) { 

throw new IllegalArgumentException("must have at least one record"); 


} 
for (NdefRecord r : records) { 


if (r == null) { 
throw new NullPointerException("records cannot contain null"); 


} 
mRecords = records; 
} 
public NdefRecord[] getRecords() { 
return mRecords; 
} 
public int getByteArrayLength() { 
int length = 0; 
for (NdefRecord r : mRecords) { 
length += r.getByteLength(); 
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} 
return length; 
j 
public byte[] toByteArray() 1 
int length — getByteArrayLength(); 
ByteBuffer buffer — ByteBuffer.allocate(length); 


for (int 1-0; i<mRecords.length; i++) { 
boolean mb = (i == 0); // first record 
boolean me = (i == mRecords.length - 1); // last record 
mhRecords[i].write ToByteBuffer(buffer, mb, me); 
j 
return buffer.array(); 
j 
@Override 
public int describeContents() { 
return 0; 
} 
@Override 
public void writeToParcel(Parcel dest, int flags) { 
dest.writeInt(mRecords.length); 
dest.writeTypedArray(mRecords, flags); 
} 
public static final Parcelable.Creator<NdefMessage> CREATOR = 
new Parcelable.Creator<NdefMessage>() { 
@Override 
public NdefMessage createFromParcel(Parcel in) { 
int recordsLength = in.readInt(); 
NdefRecord[] records = new NdefRecord[recordsLength]; 
in.readTypedArray(records, NdefRecord. CREATOR); 
return new NdefMessage(records); 
j 
@Override 
public NdefMessage[] newArray(int size) { 
return new NdefMessage[ size]; 


h 
@Override 
public int hashCode() { 
return Arrays.hashCode(mRecords); 
} 
@Override 
public boolean equals(Object obj) { 
if (this == obj) return true; 
if (obj == null) return false; 
if (getClass() != obj.getClass()) return false; 
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NdefMessage other = (NdefMessage) obj; 
return Arrays.equals(mRecords, other.mRecords); 


} 
@Override 
public String toString() { 
return "NdefMessage " + Arrays.toString(mRecords); 


j 


(4) TAG 

类 TAG 1E X frameworks Wbase core java android nfe Tag.java 中 定义 ， 此 类 用 于 标示 一 个 
被 动 的 NFC 目标 ， 比 如 TAG. CARD 和 钥匙 挂 扣 ， 其 至 是 一 个 电话 模拟 的 NFC 卡 。 当 一 个 
TAG 被 检测 到 时 ， 一 个 TAG 对 象 将 被 创建 并 且 封 装 到 一 个 Intent 里 ， 然 后 NFC 发 布 系统 将 
这 个 Intent 用 startActivity0 发 送 到 注册 了 接受 这 种 Intent DÉI Activity 里 ,可 以 用 方法 getTechList() 
来 得 到 这 个 TAG 支持 的 技术 细节 ， 并 创建 一 个 android.nfc.tech 提供 的 相应 的 TagTechnology 
对 象 。 文 件 Tag.java 的 具体 实现 代码 如 下 。 


public final class Tag implements Parcelable { 
final byte[] mld; 
final int[] mTechList; 
final String[] mTechStringList; 
final Bundle[] mTechExtras; 
final int mServiceHandle; 
final INfeTag mTagService; 
int mConnectedTechnology; 
public Tag(byte[] id, int[] techList, Bundle[] techListExtras, int serviceHandle, 
INfcTag tagService) { 
if (techList == null) ( 
throw new IllegalArgumentException("rawTargets cannot be null"); 
j 
mld = id; 
mTechList = Arrays.copyOf(techList, techList.length); 
mTechStringList = generateTechStringList(techList); 
// 确保 mTechExtras HI mTechList 一 臻 
mTechExtras = Arrays.copyOf(techListExtras, techList.length); 
mServiceHandle = serviceHandle; 
mTagService = tagService; 
mConnectedTechnology = -1; 
j 
public static Tag createMockTag(byte[] id, int[] techList, Bundle[] techListExtras) { 
return new Tag(id, techList, techListExtras, 0, null); 


} 
(5)“tech\” 子 目录 
除 此 之 外 , 在 frameworks\base\core\java\androidnfc\tech\ 目 录 中 包含 了 查询 TAG 属性 和 进 
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fT VO 操作 的 类 。 这 些 类 分 别 标示 一 个 TAG 文 持 的 不 同 的 NEFC 技术 标准 ， 如 图 11-2 所 示 。 


| BasicTagTechnology. java 
| IsoDep. java 
| Mi fareClassic. java 
MifareVltralight. java 
| Ndef. java 
| NdefFormatable. java 
| NEck. java 
| NfcB. java 
| NR£cBarcode. java 
NfcF. java 
| NfcV. java 
e package. html 
; TagTechnology. java 


图 11-2 frameworks Wbase core java android nfcXtechN H 2 


在 图 11-2 所 示 的 目录 中 ， 类 TagTechnology 是 如 表 11-2 中 所 示 的 类 必须 要 实现 的 。 


表 11-2 必须 实现 TagTechnology 的 类 


类 说 — 明 

NfcA SEFF ISO 14443-3A 标准 的 操作 。Provides access to NFC-A (ISO 14443-3A) properties and I/O operations. 
NfcB Provides access to NFC-B (ISO 14443-3B) properties and I/O operations. 

NfcF Provides access to NFC-F (JIS 6319-4) properties and I/O operations. 

NfcV Provides access to NFC-V (ISO 15693) properties and I/O operations. 
IsoDep Provides access to ISO-DEP (ISO 14443-4) properties and I/O operations. 

Ndef 提供 对 那些 被 格式 化 为 NDEF 的 tag 的 数据 的 访问 和 其 他 操作 。 


而 类 NdefFormatable 对 那些 可 以 被 格式 化 成 NDEF 格式 的 TAG 提供 了 一 个 格式 化 的 
操作 ， 文 件 frameworks\base\core\java\android\nfc\tech\NdefFormatable.java 的 具体 实现 代 
码 如 下 。 


public final class NdefFormatable extends BasicTagTechnology { 
private static final String TAG = "NFC"; 
public static NdefFormatable get(Tag tag) { 
if (Itag.hasTech(TagTechnology. NDEF FORMATABLE)) return null; 
try 1 
return new NdefFormatable(tag); 
} catch (RemoteException e) { 
return null; 


j 
void format(NdefMessage firstMessage, boolean makeReadOnly) throws IOException, 


FormatException { 
checkConnected(); 
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try { 
int serviceHandle = mTag.getServiceHandle(); 
INfcTag tagService = mTag.getTagService(); 
int errorCode = tagService.formatNdef(serviceHandle, MifareClassic. KEY DEFAULT); 
switch (errorCode) { 
case ErrorCodes.SUCCESS: 
break; 
case ErrorCodes.ERROR IO: 
throw new IOException(); 
case ErrorCodes.ERROR INVALID PARAM: 
throw new FormatException(); 
default: 
throw new IOException(); 
} 
/ 检查 并 查看 是 否 工作 
if (!tagService.isNdef(serviceHandle)) { 
throw new IOException(); 


j 
if (firstMessage != null) { 
errorCode = tagService.ndefWrite(serviceHandle, firstMessage); 
switch (errorCode) { 
case ErrorCodes.SUCCESS: 
break; 
case ErrorCodes.ERROR IO: 
throw new IOException(); 
case ErrorCodes.ERROR INVALID PARAM: 
throw new FormatException(); 
default: 
throw new IOException(); 


} 
// 选择 只 读 
if (makeReadOnly) { 
errorCode = tagService.ndefMakeReadOnly(serviceHandle); 
switch (errorCode) { 
case ErrorCodes.SUCCESS: 
break; 
case ErrorCodes.ERROR_IO: 
throw new IOException(); 
case ErrorCodes.ERROR INVALID PARAM: 
throw new IOException(); 
default: 
throw new IOException(); 


j 


} catch (RemoteException e) { 
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Log.e(TAG, "NFC service dead", e); 


j 


类 MifareClassic 在 文件 frameworksWbase core java android nfc tech WMifareClassic.java 中 定 
X, WR Android 设备 支持 MIFARE， 则 提供 针对 MIFARE Classic 目标 的 属性 和 UO 操作 。 
文件 MifareClassic.java 的 具体 实现 代码 如 下 。 


public final class MifareClassic extends BasicTagTechnology { 
private static final String TAG = "NFC"; 
public static final byte[] KEY DEFAULT = 
{(byte)OxFF, (byte)OxFF,(byte)0xFF ,(byte)OxFF,(byte)OxFF, (byte)OxFF}; 
public static final byte[] KEY MIFARE APPLICATION DIRECTORY = 
{(byte)0xA0,(byte)0xA 1 ,(byte)0xA2,(byte)0xA3,(byte)0xA4,(byte)0xA5}; 
public static final byte[] KEY NFC FORUM = 
{(byte)0xD3,(byte)0xF7,(byte)0xD3,(byte)0xF7,(byte)0xD3,(byte)0xF7}; 
public static final int TYPE UNKNOWN = -1; 
public static final int TYPE CLASSIC = 0; 
public static final int TYPE PLUS = 1; 
public static final int TYPE PRO = 2; 
public static final int SIZE 1K = 1024; 
public static final int SIZE 2K = 2048; 
public static final int SIZE 4K = 4096; 
public static final int SIZE MINI = 320; 
public static final int BLOCK_SIZE = 16; 
private static final int MAX BLOCK COUNT = 256; 
private static final int MAX SECTOR COUNT = 40; 
private boolean mIsEmulated; 
private int mType; 
private int mSize; 
public static MifareClassic get(Tag tag) { 
if (Itag.hasTech(TagTechnology.MIFARE CLASSIC)) return null; 
try { 
return new MifareClassic(tag); 
} catch (RemoteException e) { 
return null; 


j 
public MifareClassic(Tag tag) throws RemoteException 1 
super(tag, TagTechnology.MIFARE CLASSIC); 
NfcA a = NfcA.get(tag); // MIFARE Classic is always based on NFC a 
mlsEmulated = false; 
switch (a.getSak()) { 
case 0x01: 
case 0x08: 
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mType = TYPE CLASSIC; 
mSize = SIZE_1K; 
break; 

case 0x09: 
mType = TYPE CLASSIC; 
mSize = SIZE MINI; 
break; 

case 0x10: 
mType = TYPE PLUS; 
mSize = SIZE 2K; 
// SecLevel = SL2 
break; 

case Ox11: 
mType = TYPE PLUS; 
mSize = SIZE _ 4K; 
// Seclevel = SL2 
break; 

case 0x18: 
mType = TYPE CLASSIC; 
mSize = SIZE _ 4K; 
break; 

case 0x28: 
mType = TYPE CLASSIC; 
mSize = SIZE_1K; 
mlsEmulated = true; 
break; 

case 0x38: 
mType = TYPE CLASSIC; 
mSize = SIZE _ 4K; 
mlsEmulated = true; 
break; 

case 0x88: 
mType = TYPE CLASSIC; 
mSize = SIZE_1K; 
// NXP-tag: false 
break; 

case 0x98: 

case OxB8: 
mType = TYPE PRO; 
mSize = SIZE 4K; 
break; 

default: 
throw new RuntimeException( 

"Tag incorrectly enumerated as MIFARE Classic, SAK =" + a.getSak()); 
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28 MifareUltralight 在 文件 frameworks\base\core\java\android\nfc\tech\MifareUltralight.java 中 定 
X, WMR Android 设备 支持 MIFARE， 则 提供 针对 MIFARE Ultralight 目标 的 属性 和 IO 操作 。 


public final class MifareUltralight extends BasicTagTechnology { 
private static final String TAG = "NFC"; 
public static final int TYPE UNKNOWN = -1; 
public static final int TYPE ULTRALIGHT = 1; 
public static final int TYPE ULTRALIGHT C =2; 
public static final int PAGE SIZE = 4; 
private static final int NXP MANUFACTURER ID = 0x04; 
private static final int MAX PAGE COUNT = 256; 
public static final String EXTRA IS UL C = "isulc"; 
private int mType; 
public static MifareUltralight get(Tag tag) { 
if (!tag.hasTech(TagTechnology.MIFARE ULTRALIGHT)) return null; 
try { 
return new MifareUltralight(tag); 
} catch (RemoteException e) { 
return null; 


j 
public MifareUltralight(Tag tag) throws RemoteException { 
super(tag, TagTechnology.MIFARE ULTRALIGHT); 
NfcA a = NfcA.get(tag); 
mType = TYPE UNKNOWN; 
if (a.getSak()- — 0x00 && tag.getId()0] == NXP MANUFACTURER ID) { 
Bundle extras = tag.getTechExtras(TagTechnology. MIFARE ULTRALIGHT); 
if (extras.getBoolean(EXTRA IS UL C)) { 
mType = TYPE ULTRALIGHT C; 
} else { 
mType = TYPE ULTRALIGHT; 


} 

public byte[] readPages(int pageOffset) throws IOException { 
validatePageIndex(pageOffset); 
checkConnected(); 


byte[] cmd = { 0x30, (byte) pageOffset) ; 
return transceive(cmd, false); 
} 
public void writePage(int pageOffset, byte[] data) throws IOException { 
validatePageIndex(pageOffset); 
checkConnected(); 
byte[] cmd = new byte[data.length + 2]; 
cmd[0] = (byte) 0xA2; 
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cmd[1] = (byte) pageOffset; 
System.arraycopy(data, 0, cmd, 2, data.length); 
transceive(cmd, false); 
} 
public void setTimeout(int timeout) { 
try 1 
int err = mTag.getTagService().setTimeout( 
TagTechnology.MIFARE ULTRALIGHT, timeout); 
if (err != ErrorCodes.SUCCESS) { 
throw new IllegalArgumentException("The supplied timeout is not valid"); 
} 
} catch (RemoteException e) { 
Log.e(TAG, "NFC service dead", e); 


j 


public int getTimeout() { 
try { 


return mTag.getTagService().getTimeout(TagTechnology.MIFARE ULTRALIGHT); 


} catch (RemoteException e) { 
Log.e(TAG, "NFC service dead", e); 
return 0; 


j 
private static void validatePageIndex(int pageIndex) { 
if (pageIndex « 0 || pageIndex >= MAX PAGE COUNT) { 
throw new IndexOutOfBoundsException("page out of bounds: " + pageIndex); 


11.3.2 分 析 JN 部 分 
在 Android 系统 中 ，NFC 模块 的 JNI 代码 在 如 下 的 目录 中 。 


a 


\packages\apps\Nfc\nxp\jni 


INI 代码 向 上 会 跟 Framework 层 的 Java 代码 进行 交互 ， 向 下 会 跟 libnfe 层 进行 交互 。 
INI 层 的 核心 文件 是 com android nfe NativeNfcManagercpp， 功 能 是 初始 化 并 启动 NFC 


KS 


服务 ， 并 扫描 和 读 取 TAG. XF com android nfc NativeNfcManager.cpp 的 主要 
如 下 。 


static void client kill deferred call(void* arg) 


{ 


struct nfc jni native data *nat — (struct nfc jni native data *)arg; 


nat->running = FALSE; 
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static void kill client(nfc jni native data *nat) 
1 
phDal4Nfc Message Wrapper t wrapper; 
phLibNfc DeferredCall t *pMsg; 
usleep(50000); 
ALOGD("Terminating client thread..."); 
pMsg = (phLibNfc DeferredCall t*)malloc(sizeof(phLibNfc DeferredCall t)); 
pMsg->pCallback = client kill deferred call; 
pMsg->pParameter = (void*)nat; 
wrapper.msg.eMsgType = PH LIBNFC DEFERREDCALL MSG; 
wrapper.msg.pMsgData = pMsg; 


wrapper.msg.Size = sizeof(phLibNfc DeferredCall t); 
phDal4Nfc_msgsnd(gDrvCfg.nClientld, (struct msgbuf *)&wrapper, sizeof(phLibNfc Message t), 0); 
j 
static void nfc jni ioctl callback(void *pContext, phNfc sData t *pOutput, NFCSTATUS status) { 
struct nfc jni callback data * pCallbackData — (struct nfc jni callback data *) pContext; 
LOG CALLBACK('"nfc jni ioctl callback", status); 
PRG eH ASA ESE A */ 
pCallbackData->status = status; 
sem_post(&pCallbackData->sem); 


} 
static void nfc jni deinit download callback(void *pContext, NFCSTATUS status) 
1 
struct nfc jni callback data * pCallbackData — (struct nfc jni callback data *) pContext; 
LOG CALLBACK("nfc jni deinit download callback", status); 
PH BRASSERIE IH Tra 
pCallbackData->status = status; 
sem_post(&pCallbackData->sem); 


static int nfc jni download locked(struct nfc jni native data *nat, uint8 t update) 
1 

uint8 t OutputBuffer[1]; 

uint8 t InputBuffer[1]; 

struct timespec ts; 

NFCSTATUS status - NFCSTATUS FAILED; 

phLibNfc StackCapabilities t caps; 

struct nfc jni callback data cb data; 

bool result; 

(Bilt ASH Kai 

if (Infc_cb_data_init(&cb_data, NULL)) 

1 

goto clean and return; 


} 
if(update) 
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{ 

//deinit 

TRACE("phLibNfc Mer Delnitialize() (download)"); 

REENTRANCE LOCK(); 

status = phLibNfc Mgt Delnitialize(gHWRef, nfc jni deinit download callback, (void *)&cb data); 

REENTRANCE UNLOCK(); 

if (status != NFCSTATUS PENDING) 

{ 
ALOGE("phLibNfc Met Delnitialize() (download) returned 0x%04x[%s]", status, 
nfc jni get status name(status)); 

j 

clock gettime(CLOCK REALTIME, &ts); 

ts:tv sec t= 5; 

/* 等 待 回 调 响应 */ 

if(sem_timedwait(&cb_data.sem, &ts)) 


{ 


ALOGW("Deinitialization timed out (download)"); 
} 
if(cb_data.status != NFCSTATUS SUCCESS) 
1 
ALOGW("Deinitialization FAILED (download)"); 
} 
TRACE("Deinitialization SUCCESS (download)"); 
} 


result = performDownload(nat, false); 


if (result) { 
status = NFCSTATUS FAILED; 
goto clean and return; 
j 
TRACE("phLibNfc Mgt Initialize()"); 
REENTRANCE LOCK() 
status = phLibNfc Met Initialize(gHWRef, nfc jni init callback, (void *)&cb data); 
REENTRANCE UNLOCKY(); 
if(status != NFCSTATUS PENDING) 


{ 
ALOGE("phLibNfc_ Mgt Initialize() (download) returned 0x%04x[%s]", status, nfc_jni_get_ 
status name(status)); 
goto clean and return; 

j 


TRACE("phLibNfc Met Initialize() returned 0x%04x[%s]", status, nfc jni get status name 
(status)); 
if(sem wait(&cb data.sem)) 
1 
ALOGE("Failed to wait for semaphore (errno-0x9?608x)", errno); 
status = NFCSTATUS FAILED; 
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goto clean and return; 


} 
族 初 始 化 状态 */ 
if(cb data.status != NFCSTATUS SUCCESS) 
{ 
status = cb_data.status; 
goto clean_and_return; 
} 
/* ====== CAPABILITIES ======= */ 


REENTRANCE LOCK(); 

status = phLibNfc Mgt GetstackCapabilities(&caps, (void*)nat); 
REENTRANCE UNLOCK(; 

if (status != NFCSTATUS SUCCESS) 


{ 
ALOGWY("phLibNfc Mgt GetstackCapabilities returned 0x%04x[%s]", status, nfc_jni_get_ 
status name(status)); 
} 
else 
{ 
ALOGD("NFC capabilities: HAL = %x, FW = Vox, HW = Vox, Model = Vox, HCI = %x, 
Full FW = %d, Rev = %d, FW Update Info = %d", 
caps.psDevCapabilities.hal version, 
caps.psDevCapabilities.fw version, 
caps.psDevCapabilities.hw version, 
caps.psDevCapabilities.model id, 
caps.psDevCapabilities.hci version, 
caps.psDevCapabilities.full version[NXP FULL VERSION LEN-1], 
caps.psDevCapabilities.full version[NXP FULL VERSION LEN-2], 
caps.psDevCapabilities.firmware update info); 
} 
= FRR 


status = NFCSTATUS_SUCCESS; 


clean_and_return: 


} 


nfc_cb_data_deinit(&cb_data); 
return status; 


static int nfc jni configure driver(struct nfc jni native data *nat) 


1 


char value[PROPERTY VALUE MAX]; 

int result - FALSE; 

NFCSTATUS status; 

gDrvCfg.nClientId = phDal4Nfc_msgget(0, 0600); 


TRACE("phLibNfc Met ConfigureDriver(0x%08x)", gDrvCfg.nClientld); 
REENTRANCE LOCK(; 
status = phLibNfc Mgt ConfigureDriver(&gDrvCfg, &gHWRef); 
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REENTRANCE UNLOCKY(); 

if(status == NFCSTATUS ALREADY INITIALISED) 1 
ALOGWY("phLibNfc Met ConfigureDriver() returned 0x%04x[%s]", status, nfc jni get - 
status name(status)); 


j 

else if(status != NFCSTATUS SUCCESS) 

i 
ALOGE("phLibNfc Mgt ConfigureDriver() returned 0x%04x[%s]", status, nfc jni get ` 
status name(status)); 
goto clean and return; 

j 


TRACE("phLibNfc Met ConfigureDriver() returned 0x%04x[%s]", status, nfc jni get status 
name(status)); 


if(pthread_create(&(nat->thread), NULL, nfc jni client thread, nat) != 0) 
H 

ALOGE("pthread_create failed"); 

goto clean_and_return; 


} 
driverConfigured = TRUE; 


clean_and_return: 


} 


return result; 


static int nfc jni unconfigure driver(struct nfc jni native data *nat) 


1 


int result - FALSE; 
NFCSTATUS status; 
PH aKa / 
TRACE("phLibNfc Mgt UnConfigureDriver()"); 
REENTRANCE LOCK(); 
status = phLibNfc Mgt UnConfigureDriver(gHWRef); 
REENTRANCE UNLOCK(; 
if(status != NFCSTATUS SUCCESS) 
{ 
ALOGE("phLibNfc_ Mgt UnConfigureDriver() returned error 0x%04x[%s] -- this should 
never happen", status, nfc jni get status name( status)); 
} 
else 
{ 
ALOGD("phLibNfc_ Met UnConfigureDriver() returned 0x%04x[%s]", status, nfc_jni_get_ 
status_name(status)); 
result = TRUE; 
} 
driverConfigured = FALSE; 
return result; 
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11.3.3 ”分 析 底 层 
在 Android 系统 中 ，NFC 模块 的 底层 部 分 由 驱动 部 分 和 libnfc 库 部 分 两 大 类 。 驱 动 部 分 
在 “device” 目 录 中 实现 ， 而 “libnfe-nci” 和 “libnfec-nxp” 目 录 中 的 底层 文件 则 负责 NFC 数 
据 的 读 取 和 解析 工作 。 


1.4 f£ Android 系统 中 开发 NFC App 的 方法 


当 Android 手机 开启 了 NFC 程序 ， 并 且 检 测 到 一 个 TAG Ja, TAG 分 发 系统 会 自动 创建 
一 个 封装 了 NFC TAG 信息 的 ntent。 如 果 多 于 一 个 应 用 程序 能 够 处 理 这 个 Pntent， 那 么 手机 
就 会 弹出 一 个 对 话 框 ， 让 用 户 选 择 处 理 该 TAG 的 Activity。 在 TAG 分 发 系统 中 定义 了 3 种 
Intent， 按 优先 级 从 高 到 低 排 列 如 下 。 

口 NDEF DISCOVERED。 

口 TECH DISCOVERED。 

口 TAG DISCOVERED. 

“4 Android 设备 检测 到 有 NFC TAG 靠近 时 ， 会 根据 Action 申明 的 顺序 向 对 应 的 Activity 
发 送 包含 NFC 消息 的 Intent 。 因 为 此 处 使 用 的 intent-filter 的 Action 类 型 为 TECH - 
DISCOVERED， 所 以 可 以 处 理 所 有 类 型 为 ACTION TECH DISCOVERED 的 、 并 且 使 用 的 技 
术 为 在 nfc_tech_filter.xml 文件 中 定义 的 类 型 的 TAG。 

当 Android 手机 检测 到 一 个 TAG 时 ， 启 用 Activity 的 匹配 过 程 如 图 11-3 所 示 。 


LR 


< No 


Activity registered to - 


L—— Yes 


e 
NDEF_DISCOVERED? | 


Activitiy registed to | m | 
,| Intentdeliveredto | 
handle Yes > Activity 


TECH DISCOVERED? | | 


! 
[ Activities registered to | 

handle Yes 
| TAG DISCOVERED? | 


图 11-3 ”启用 Activity 的 匹配 过 程 


在 Android 系统 中 ， 开 发 NFC App 的 基本 流程 如 下 。 
(1) 在 相关 的 androidManifest 文件 中 设置 NEC 权限 ， 具 体 代 人 码 如 下 。 


<uses-permission android:name="android.permission.NFC"/> 
(2) 设置 SDK 的 级 别 限制 ， 例 如 设置 为 API 10。 
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<uses-sdk android:minSdk Version="10"/> 


(3) 声明 特殊 功能 的 限制 权限 ,通过 如 下 代码 声明 可 以 让 应 用 程序 在 Google Play 上 声明 
使 用 者 必须 拥有 NFC 功能 。 


<uses-feature android:name="android.hardware.nfc" android:required="true" /> 


(4) 实现 NFC 标签 过 滤 

在 Activity 的 Intent 过 滤 XML 声明 中 ， 可 以 同时 声明 过 滤 如 下 三 种 Action， 但 是 需要 提 
前 获知 系统 在 发 送 Intent 时 拥有 的 优先 级 。 

D 动作 一 : 过 滤 ACTION TAG DISCOVERED， 代 码 如 下 。 


<intent-filter> 
«action android:name="android.nfc.action. TAG DISCOVERED"/- 
«category android:name-"android.intent.category.DEFAULT"/^ 


</intent-filter> 


这 个 最 简单 ， 也 是 最 后 一 个 被 尝试 接受 intent 的 选项 。 
O 动作 二 : 过 滤 ACTION NDEF DISCOVERED， 代 码 如 下 。 


<intent-filter> 

«action androlid:name="android.nfc.action.NDEF DISCOVERED"/> 
«category android:name="android.intent.category.DEFAULT"/> 
<data android:mimeType="text/plain" /> 


</intent-filter> 


其 中 最 重要 的 是 data 的 mimeType 类 型 ， 此 定义 越 准确 ，Intent 指向 这 个 Activity 的 成 功 
率 就 越 高 ， 否则 系统 可 能 不 会 发 出 想 要 的 NDEF intent 了 。 

口 动作 三 : 过 滤 ACTION_TECH_DISCOVERED. 

首先 需要 在 <project-path>/res/xml 下 面 创 建 一 个 过 滤 规 则 文件 ， 可 以 任意 命名 ， 例 如 可 以 
命名 为 nfc_tech_filter.xml。 这 个 里 面 定义 的 是 NFC 实现 的 各 种 标准 , 每 一 个 NFC 卡 都 会 符合 
多 个 不 同 的 标准 。 可 以 在 检测 到 NFC 标签 后 ， 使 用 getTechList0) 方 法 来 查看 所 检测 的 TAG 到 
底 支 持 哪 些 NFC 标准 。 在 一 个 nfe_ tech filterxml 文件 中 可 以 定义 多 个 <tech-list> 结 构 组 ， 每 
一 组 表示 只 接受 同时 满足 这 些 标准 的 NEC 标签 ,比如 A 组 表示 , 只 有 同时 满足 oDep、NfeA、 
NfcB. NfcF 这 4 个 标准 的 NFC 标签 的 Intent 才能 进入 。B 组 表示 , 只 有 同时 满足 NfcV、Ndef、 
NdefFormatable、MifareClassic 和 MifareUltralight XX 5 个 标准 的 NFC 标签 的 Intent 才能 进入 。 
A 与 B 组 之 间 的 关系 就 是 只 要 满足 其 中 一 个 就 可 以 了 。 换 句 话说 ,，NFC 标签 技术 满足 A 的 声 
明 也 可 以 ,满足 B 的 声明 也 可 以 。 


«resources xmlns:xliff="urn:oasis:names:tc:xliff:document: 1.2"> 

A eneen A 2H 

<tech>android.nfc.tech.IsoDep</tech> <tech>android.nfc.tech.NfcA</tech> 
<tech>android.nfc.tech.NfcB</tech> <tech>android.nfc.tech.NfcF</tech> 

</tech-list> 

Eom p ———— B 2H 
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<tech>android.nfc.tech.NfcV</tech> <tech>android.nfc.tech.Ndef</tech> 


<tech>android.nfc.tech.NdefFormatable</tech> 

<tech>android.nfc.tech.MifareClassic</tech> 

<tech>android.nfc.tech.MifareUltralight</tech> 
</tech-list> 


</resources> 


在 androidManifest 文件 中 ， 声 明 xml 过 滤 的 举例 代码 如 下 。 


<activity> 
<intent-filter> 
«action android:name="android.nfc.action. TECH. DISCOVERED"/- 
</intent-filter> 
<meta-data android:name="android.nfc.action. TECH. DISCOVERED" 


"@xml/nfc_tech_filter" />------------- 这 个 就 是 你 的 资源 文件 名 


</activity> 


(5) 创建 NFC 标签 的 前 台 分 发 系统 
什么 是 NFC 的 前 台 发 布 系统 ?就 是 当 打 开 应 用 的 时 候 ， 通 过 前 


让 已 经 启动 的 Activity 拥有 更 高 的 优先 级 ， 且 依据 在 代码 中 定义 的 标准 


android:resource= 


而 不 是 让 其 他 声明 了 Intent Filter 的 Activity 来 干扰 ， 甚 至 连 自己 声 


中 的 Intent Filter 都 不 能 干扰 。 也 就 是 说 ， 


明 在 


发 布 系统 的 设置 ， 可 以 
来 过 滤 和 处 理 Intent, 


文件 androidManifest 


两 种 情况 。 
O 第 一 种 情况 : 当 Activity 没有 启动 的 时 候 去 扫描 TAG， 那 


口 


都 将 一 起 参与 过 小 。 
第 二 种 情况 : 当 Actiity 启动 去 扫描 TAG 时 ， 将 直接 使 用 在 部 


么 系统 


EHI f 


前 台 分 发 的 优先 级 大 于 Intent Filter。 此 时 有 如 下 的 


所 有 的 Intent Filter 


台 分 发 系统 代码 中 写 入 


的 过 滤 标准 。 如 果 这 个 标准 没有 命中 任何 Intent, 那么 系统 将 使 用 所 有 Activity 声明 的 


Hi 


Intent Filter xml 来 过 滤 。 


例如 在 OnCreate 中 ， 可 以 添加 如 下 的 代码 。 


mPendingIntent = PendingIntent.getActivity(this, 0, 


new Intent(this, getClass()).addFlags(Intent. FLAG ACTIVITY SINGLE TOP), 0); 

// 做 一 个 IntentFilter 过 滤 你 想 要 的 action 这 里 过 滤 的 是 ndef 
IntentFilter ndef = new IntentFilter(NfcAdapter. ACTION NDEF DISCOVERED); 

/如 果 对 action 的 定义 有 更 高 的 要 求 ， 比 如 data 的 要 求 ， 可 以 使 用 如 下 的 代码 来 定义 intentFilter 


// try { 
// ndef.addDataType("*/*"); 
// } catch (MalformedMimeTypeException e) 1 
// // TODO Auto-generated catch block 
// e.printStackTrace(); 
// } 
/生成 intentFilter 
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mFilters = new IntentFilter[] { 
ndef, 

h 

/ 做 一 个 tech-list。 可 以 看 到 是 二 维 数据 ， 每 一 个 一 维 数组 之 间 的 关系 是 或 ， 但 是 一 个 一 

维 数组 之 内 的 各 个 项 就 是 与 的 关系 了 

mTechLists = new String[][] { 
new String[] { NfcF.class.getName()}, 
new String[]{NfcA.class.getName()}, 
new String[]{NfcB.class.getName()}, 
new String[]{NfcV.class.getName()} 
h 


在 onPause 和 onResume 中 需要 加 入 如 下 相应 的 代码 。 


public void onPause() { 
super.onPause(); 
// 反 注册 mAdapter.disableForegroundDispatch(this); 
} 
public void onResume() { 


super.onResume(); 
// 设 定 intentfilter 和 tech-list。 如 果 两 个 都 为 null 就 代表 优先 接收 任何 形式 的 TAG Action。 也 就 是 
/说 系统 会 主动 发 TAG intent. 
mAdapter.enableForegroundDispatch(this, mPendingIntent, mFilters, mTechLists); 
} 


1.5 ”实战 演练 一 一 使 用 NFC 发 送 消息 


当 Android 设备 检测 到 有 NFC TAG 时 ， 预 期 的 行为 是 触发 最 合适 的 Activity 来 处 理 检 测 
到 的 TAG， 这 是 因为 NFC 通常 是 在 非常 近 的 距离 才 起 作用 (<4m)。 如 果 在 此 时 需要 用 户 来 选 
择 合适 的 应 用 来 处 理 TAG, 则 很 容易 断 开 与 TAG 之 间 的 通信 , 因此 我 们 需要 选择 合适 的 Intent 
Filter 只 处 理想 读 写 的 TAG 类 型 。Android 系统 支持 两 种 NFC 消息 发 送 机 制 ， 分 别 是 Intent 
发 送 机 制 和 前 台 Activity 消息 发 送 机 秆 
O Intent 发 送 机 制 : 当 系 统 检测 到 TAG I, Android 系统 提供 manifest 中 定义 的 Intent 
Filter 来 选择 合适 的 Activity 来 处 理 对 应 的 TAG， 当 有 多 个 Activity 可 以 处 理 对 应 的 

TAG 类 型 时 ， 则 会 显示 Activity 选择 窗口 由 用 户 选择 ， 如 图 11-4 所 示 。 


Select an action 


NFC TagInfo 


= 


o 


m . 
P Reading Example 


s Tags 


图 11-4 选择 窗口 
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是 使 用 Android 的 Manifest 来 说 明 ， 一 个 是 通过 代码 来 声明 。 


在 接 下 来 的 内 容 中 , 将 通过 一 个 具体 实例 的 实现 过 程 , 来 讲解 在 Android 系统 
消息 发 送 机 制 的 基本 方法 。 


口 前 台 Activity 消息 发 送 机 制 :允许 一 个 在 前 台 运 行 的 Activity 在 读 写 NFC TAG BTE. 
有 优先 权 ， 此 时 如 果 Android 检测 到 有 NFC TAG， 且 如 果 前 台 人 允许 的 Activity 可 以 处 
理 该 种 类 型 的 TAG， 则 该 Activity 具有 优先 权 ， 不 出 现 Activity 选择 窗口 。 
方法 基本 上 都 是 使 用 Intent Filter 来 指明 Activity 可 以 处 理 的 TAG 


类 型 ， st 


中 使 用 NFC 


实 例 Xj 能 源码 路 径 
实例 11-1 演示 NFC 消息 发 送 机 制 的 基本 用 法 daimaM I \NFCEX 


本 实例 的 具体 实现 流程 如 下 。 


(1) 在 文件 AndroidManifestxml 中 声明 NFC 权限 ， 具 体 实现 代码 如 下 。 


«manifest xmlns:android="http://schemas.android.com/apk/res/android" 


package="com.pstreets.nfc" 
android:versionCode="1" 
android:versionName="1.0"> 
<uses-sdk android:minSdkVersion="10" /> 
<uses-permission android:name="android.permission.NFC" /> 
«uses-feature android:name-"android.hardware.nfc" android:required="true" /> 
«application android:icon="(@drawable/icon" android:label="@string/app_name"> 
«activity android:name="._NFCDemoActivity" 
android:label="@string/app_name" 
android:launchMode="singleTop"> 
<intent-filter> 
«action android:name-"android.intent.action. MAIN" /> 
«category android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
<intent-filter> 
«action android:name-"android.nfc.action.NDEF DISCOVERED"/> 
«data android:mimeType="text/plain" /> 
</intent-filter> 
<intent-filter 
> 
<action 
android:name="android.nfc.action. TAG_DISCOVERED" 
> 
</action> 
<category 
android:name="android.intent.category. DEFAULT" 
> 
</category> 
</intent-filter> 
<!-- Add a technology filter --> 


<intent-filter> 


EN 339 


Android 网 络 开发 从 入 门 到 精通 


«action android:name="android.nfc.action.TECH DISCOVERED"/> 


</intent-filter> 
<meta-data android:name="android.nfc.action. TECH_DISCOVERED" 
android:resource="(@xml/filter_nfc" 
[^ 
</activity> 
«activity android:name=".MainActivity" 
android:label="@string/app_name"> 
<intent-filter> 
«action android:name="android. intent.action. MAIN" /> 
«category android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


这 样 通过 上 述 声 明代 码 ， 当 Android 检测 到 有 TAG 时 ， 会 显示 Activity 选择 窗口 ， 显 示 


效果 如 前 面 的 图 11-4 所 示 。 
(2) 编写 布局 文件 main.xml， 功 能 是 通过 文本 控件 显示 当前 的 扫描 状态 ， 


Cu 


具体 实现 代码 


如 下 。 
<RelativeLayout 
xmins:android-"http://schemas.android.com/apk/res/android" 


android:layout width-"match parent" 

android:layout height-"match parent" 

android:text="@string/title"> 

<TableLayout 
android:id="(@+id/purchScanTable1" 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
<TableRow 
android:id="@+id/tablel Row 1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
«TextView 
android:id="(@+id/status_label" 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="Current Status: " /> 
<TextView 
android:id="(@+id/status_data" 


LM 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-" Scan a Tag" /> 
</TableRow> 


<View 
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android:id-" (a)--id/purchScanES 1" 

android:layout width-"match parent" 
android:layout height-"55px" 
android:layout below-"(a)id/status label" 
android:background="#000000" /> 

<TableRow 
android:id="@-+id/table1 Row2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
«TextView 
android:id-"(a)-id/block 0 label" 


=i 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"BLOCK 0: "/> 

<TextView 
android:id="@+id/block_0_ data" 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-" " /> 
</TableRow> 
<TableRow 
android:id="@-+id/table1 Row3" 


Ln" 


android:layout width-"wrap content" 


android:layout height-" 
«TextView 
android:id-"(a)-id/block 1 label" 


wrap content" 


android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text-"BLOCK 1: "/> 

«TextView 
android:id-"(a)-id/block 1 data" 


ERI 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-" " /> 
</TableRow> 
</TableLayout> 
<View 
android:id="(@+id/purchScanES 1 " 


android:layout width-"match parent" 
android:layout_height="75px" 
android:layout_below="@id/purchScanTable1" 
android:background="#000000" /> 
<Button 
android:id="@-+id/clear_but" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
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android:layout_below="@id/purchScanES 1" 
android:gravity="center_horizontal" 
android:text="Clear" /> 


</RelativeLayout> 


(3) 编写 程序 文件 NFCDemoActiviyjava， 当 在 前 台 运 行 NFCDemoActiviy 时 ， 如 果 希 望 


只 由 它 来 处 理 Mifare 类 型 的 TAG， 此 时 可 以 使 用 前 台 消 息 发 送 机 制 。 文 伯 


ay 


NFCDemoActiviy.java 的 具体 实现 代码 如 下 。 


342 NH 


public class NFCDemoActivity extends Activity { 


private NfcAdapter mAdapter; 
private PendingIntent mPendingIntent; 
private IntentFilter[] mFilters; 
private String[][] mTechLists; 
private TextView mText; 
private int mCount = 0; 
@Override 
public void onCreate(Bundle savedState) { 
super.onCreate(savedS tate); 
setContentView(R.layout.foreground_dispatch); 
mText = (TextView) find ViewByld(R.1id.text); 
mText.setText("Scan a tag"); 
mAdapter = NfcAdapter.getDefaultA dapter(this); 
mPendingIntent = PendingIntent.getActivity(this, 0, 
new Intent(this, getClass()).addFlags(Intent FLAG ACTIVITY SINGLE TOP), 0); 
// 为 MIME 设置 一 个 过 滤器 
IntentFilter ndef = new IntentFilter(NfcAdapter.ACTION TECH DISCOVERED); 
try { 
ndef.addDataType("*/*"); 
} catch (MalformedMimeTypeException e) { 


throw new RuntimeException("fail", e); 


} 

mFilters = new IntentFilter[] { 
ndef, 

h 


// 为 MifareClassic 设置 Tag 列表 
mTechLists = new String[][] new String[] { MifareClassic.class.getName() } }; 


@Override 
public void onResume() { 
super.onResume(); 
mAdapter.enableForegroundDispatch(this, mPendingIntent, mFilters, mTechLists); 
} 
@Override 
public void onNewlIntent(Intent intent) { 
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Log.i("Foreground dispatch", "Discovered tag with intent: " + intent); 
mText.setText("Discovered tag " + ++mCount + " with intent: " + intent); 


} 

@Override 

public void onPause() { 
super.onPause(); 
mAdapter.disableForegroundDispatch(this); 


} 


这 样 在 执行 本 实例 后 ， 每 当 靠近 一 次 TAG， 计 数 就 会 增加 1。 执 行 效果 如 图 


Discovered tag 2 with intent: Intent { 
act=android.nfc.action. 
TECH_DISCOVERED flg=0x30000000 
cmp=com.pstreets.nfc/. 
NFCDemoActivity (has extras) } 


图 11-5 执行 效果 


11-5 所 示 。 
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自从 互联 网 诞生 以 来 , 电子 邮件 (E-Mail) 就 成 为 吸引 用 户 使 用 网 络 的 主要 原因 之 一 。 
无 论 是 朋友 之 间 的 祝福 和 交流 ， 还 是 商务 活动 中 的 信息 往来 ， 都 离 不 开 电 子 邮件 。 在 本 


mp, mn 


F 细 介绍 在 Android 平台 中 开发 邮件 应 用 程序 的 基本 知识 。 


12.1 在 Android 中 发 送 邮 件 的 方式 


在 开发 Android 网 络 应 用 程序 时 ， 可 以 有 多 种 实现 邮件 发 送 的 方式 。 在 本 节 的 内 容 
中 ， 将 详细 讲解 使 用 Android 系统 发 送 邮 件 的 常见 方式 ， 并 通过 具体 实例 来 讲解 其 实现 


12.1.1 使 用 Intent 方式 


在 Android 系统 中 , 可 以 使 用 Intent 调用 内 置 的 邮件 系统 的 方法 来 发 送 邮 件 。 在 具体 实现 
时 ， 需 要 调用 Intent 中 的 putExtra0 方 法 将 邮件 的 各 个 部 分 发 送 E-Mail 程序 。 方 法 putExtra() 


的 语法 格式 如 下 。 


intent.putExtra(android.content.Intent.EXTRA STREAM,URL url); 


第 一 个 参数 EXTRA STREAM 表示 传输 的 数据 ， 各 个 取 值 的 具体 说 明 如 下 。 


口 EXTRA_E-MAIL: 发 送 的 是 收 件 人 地 址 。 
口 EXTRA SUBJECT: 邮件 标题 。 
口 EXTRA_TEXT: 邮件 文本 内 容 。 
口 EXTRA STREAM: 邮件 附件 。 


第 二 个 参数 url 表示 传递 对 象 的 URL 地 址 。 


在 使 用 Intent 调用 内 置 邮件 系统 时 , 使 用 的 行为 是 android.content.Intent.ACTION_SEND。 
实际 上 在 Android 系统 中 使 用 的 邮件 发 送 服务 是 调用 Gmail 程序 ， 而 并 不 是 直接 使 用 SMTP 


协议 。 


在 接 下 来 的 内 容 中 , 将 通过 一 个 具体 实例 来 讲解 在 发 送 短信 时 实现 E-Mail 邮件 通知 的 实 


现 过 程 。 在 本 实例 


P， 当 用 户 收 到 一 条 短信 后 ， 先 用 Toast 提示 获取 了 短信 ,然后 使 用 E-Mail 


发 送 提示 到 月 8 箱 中 ， 这 样 就 可 以 将 重要 的 短信 放 在 邮箱 中 保存 ， 从 而 不 用 担心 短信 容 
量 的 问题 了 。 

Ko Bl Xj 能 源码 路 径 

实例 12- 在 收 到 短信 时 实现 E-Mail 邮件 通知 daima\12\tong 
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在 具体 实现 上 ， 先 在 后 台 设 计 一 个 BroadcastReseiver 用 于 等 待 接收 短信 。 当 接收 到 短信 
以 后 ， 使 用 Bundle 的 方式 来 封装 短信 的 内 容 ， 然 后 通过 Intent 方式 返回 给 主 程序 Activity. Ds] 
为 Receiver 无 法 直接 发 送 E-Mail， 所 以 需要 将 控制 权 回 给 主 程序 ， 通 过 主 程序 来 运行 发 送 
E-Mail 的 工作 。 当 主 程序 收 到 Bundle 后 ， 会 以 Bundle.getString 方法 来 取得 返回 短信 的 内 容 ， 
然后 以 Intent.setType(“plain/text”) 来 设置 要 打开 的 Intent 类 型 ， 并 以 关键 程序 Intent.putExtra 
(android.content.Intent.EXTRA E-MAIL,strE-mailReciver) 来 指定 要 打开 的 是 发 送 E-Mail 所 需 
要 的 Extra 参数 ， 当 Android 系统 收 到 这 些 参数 后 ， 就 会 打开 内 置 的 E-Mail 发 送 程序 。 读 者 
在 此 需要 注意 的 是 ， 在 模拟 器 运行 后 会 显示 “No application can perform this action” 的 提示 ， 
而 在 真实 机 器 上 不 会 出 现 此 问题 。 

本 实例 的 具体 实现 流程 如 下 。 

C1) 编写 布局 文件 main.xml， 通 过 TextView 控件 显示 界面 文字 ， 有 具体 实现 代码 如 下 。 


Tii 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:background="@drawable/white" 


android:orientation="Vertical" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
> 
<TextView 
android:id="@+id/myTextView1" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
/> 


</LinearLayout> 


(2) 编写 文件 AndroidManifest.xml， 向 系统 注册 一 个 常 驻 的 BroadcastReseiver， 并 设置 这 
个 Reseiver 的 intent-filter， 让 其 SMSreceiver 针对 收 到 短信 事件 做 出 反应 ， 并 声明 
android.permission.RECEIVE_SMS 权限 。 文 件 AndroidManifest.xml 的 具体 实现 代码 如 下 


o 


<intent-filter> 

<action android:name="android.intent.action.MAIN" /> 

«category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<!-- 建立 receiver 来 聆听 系统 广播 信息 -> 
«receiver android:name="irdc.tong.SMSreceiver"> 
<!-- 设置 要 捕捉 的 信息 名 是 provider 中 Telephony.SMS RECEIVED --> 

<intent-filter> 


<action 
android:name="android.provider.Telephony.SMS_ RECEIVED" /> 
</intent-filter> 
</receiver> 
</application> 
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<uses-permission android:name="android.permission.RECEIVE_ SMS"></uses-permission> 


(3) 编写 得 
中 的 字符 串 


</manifest> 


呈 序 文件 tong.java， 通 过 try 语句 获取 短信 传 来 的 bundle 堆 信 息 ， 并 取出 bunde 
B. AS HEX Intent 来 发 送 E-Mail 邮件 信息 ， 同 时 设置 邮件 格式 为 “plain/text”， 
并 分 别 取得 EditText01、EditText02、EditText03 和 EditText 04 的 值 作为 收 件 人 地 址 、 附 件 、 


主题 和 正文 , 最 后 将 取得 的 字符 串 放 入 mE-mailIntent 中 。 文件 tong.java 的 具体 实现 代码 如 下 。 
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package irdc.tong; 


import irdc.tong.R; 


import android.app.Activity; 


import android.content.Intent; 


import android.os.Bundle; 


import android.widget.TextView; 


public class tong extends Activity 


1 


[* HB] —^* TextView,String 数组 与 两 
private TextView mTextView1; 


public String[] strE-mailReciver; 

public String strE-mailSubject; 

public String strE-mailBody; 

/** Called when the activity is first created. */ 
@Override 


public void onCreate(Bundle savedInstanceState) 


super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 

/# 通 过 findViewByld 构造 器 创建 TextView x} 5 */ 
mTextView1 = (TextView) find ViewByld(R.id.myTextView 1); 
mTextView1.setText(" 等 待 中 ..."); 
try 


谨 取 得 短信 传 来 的 bundle*/ 
Bundle bunde = this.getIntent().getExtras(); 
if (bunde!= null) 


{ 
POS bunde 内 的 字符 串 取 出 */ 
String sb = bunde.getString("STR_INPUT"); 
/* Bl EXS Intent 来 运行 寄 送 E-mail 的 工作 */ 


Intent mE-mailIntent = 


new Intent(android.content.Intent. ACTION SEND); 


虚设 置 邮件 格式 为 "plain/text"*/ 
mE-mailIntent.setType("plain/text"); 
/* 

* 取得 EditText01,02,03,04 的 值 作为 


个 文本 字符 串 变 量 %/ 


ZR 
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Tt 


* (GC AHL, BAA 
E 

strE-mailReciver =new String[] {"jay.mingchieh@gmail.com"}; 
strE-mailSubject = "你 有 一 封 短 信 !1"; 

strE-mailBody = sb.toString(); 

/* 将 取得 的 字符 串 放 入 mE-mailIntent 中 */ 
mE-mailIntent.putExtra(android.content.Intent.EXTRA E-MAIL, 
strE-mailReciver); 
mE-mailIntent.putExtra(android.content.Intent. EXTRA SUBJECT, 
strE-mailSubject); 
mE-mailIntent.putExtra(android.content.Intent. EXTRA TEXT, 
strE-mailBody); 

startActivity(Intent.createChooser(mE-mailIntent, 
getResources().getString(R.string.str message))); 


JE TE SC 


} 
else 
{ 
finish(); 
} 
} 
catch(Exception e) 
{ 
e.printStackTrace(); 
} 
} 
} 
(4) 编写 文件 SMSreceiver.java, 使 用 telephoney.gsm.SmsMessage 来 接收 短信 ,使 
通知 用 户 收 到 短信 ， 主 要 代码 如 下 。 文 件 SMSreceiver.java 的 具体 实现 代码 如 下 。 


Ee 


import android.content.BroadcastReceiver; 


H BroadcastReceiver 类 */ 


import android.content.Context; 


import android.content.Intent; 


import android.os.Bundle; 


/* 


/* 


"5 
imp 
5 


imp 


H 


H 


H telephoney.gsm.SmsMessage 来 收取 短信 */ 

ort android.telephony.gsm.SmsMessage; 

H Toast 类 来 告知 用 户 收 到 短信 */ 

ort android.widget.Toast; 

9 定义 继承 自 BroadcastReceiver 类 ,聆听 系统 服务 广播 的 信息 */ 


public class SMSreceiver extends BroadcastReceiver 


{ 


/* 


* 声明 静态 字符 串 ,并 使 用 


* android.provider.Telephony. SMS RECEIVED 


1 Toast 
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* 


2 


作为 Action 为 短信 的 依据 


private static final String mACTION = 
"android.provider.Telephony.SMS_ RECEIVED"; 
private String str_receive=" 收 到 短信 !"; 

@Override 

public void onReceive(Context context, Intent intent) 


1 


// TODO Auto-generated method stub 
Toast.makeText(context, str_receive.toString(), 
Toast. LENGTH_LONG).show(); 
POA WARK Intent 是 否 为 短信 */ 
if (intent.getAction().equals(mACTION)) 
{ 
人 建构 一 字符 串 集合 变量 sb*/ 
StringBuilder sb = new StringBuilder(); 
/* BEIC EH Intent 传 来 的 数据 */ 
Bundle bundle = intent.getExtras(); 
请 判断 Intent 是 有 数据 */ 
if (bundle != null) 
1 
/* pdus 为 android 内 置 短信 参数 identifier 
* 通过 bundle.get(") 返 回 一 包含 pdus 的 对 象 */ 
Object[] myOBJpdus = (Object[]) bundle.get("pdus"); 
PHEJXS RH EDGE Z array, 并 依据 收 到 的 对 象 长 度 来 创建 array 的 大 小 */ 
SmsMessage[] messages = new SmsMessage[myOBJpdus.length]; 
for (int 1 = 0; i<myOBJpdus.length; i++) 
1 
messages[i] = 
SmsMessage.createFromPdu((byte[]) myOBJpdus[i]); 
} 
/* 将 送 来 的 短信 合并 自 定 义 信息 于 StringBuilder 当中 */ 
for (SmsMessage currentMessage : messages) 
1 
sb.append(" 接 收 到 来 自 :\n"); 
/* 收 信人 的 电话 号 码 */ 
sb.append(currentMessage.getDisplayOriginatingAddress()); 
sb.append("\n------ 传 来 的 短信 ------\n"); 
* 取得 传 来 信息 的 BODY */ 
sb.append(currentMessage.getDisplay MessageBody()); 
Toast.makeText 
( 
context, sb.toString(), Toast. LENGTH_LONG 
).show(); 
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} 
/* 以 Notification(Toase) 显 示 来 讯 信 息 */ 
Toast.makeText 
( 
context, sb.toString(), Toast.LENGTH LONG 
).show(); 
/* 返回 主 Activity */ 
Intent i = new Intent(context, tong.class); 
ID X.— Bundle*/ 
Bundle mbundle = new Bundle(); 
PRAT DL putString0) 方 法 存 入 自 定义 的 bundle 内 */ 
mbundle.putString("STR INPUT", sb.toString()); 
/*% El xE X. bundle 写 入 Intent 中 */ 
i.putExtras(mbundle); 
MRE Intent 的 Flag 以 一 个 全 新 的 task 来 运行 */ 
i.addFlags(Inten. FLAG ACTIVITY NEW TASK); 
context.startActivity(1); 
j 
j 
j 


实例 执行 后 的 效果 如 图 12-1 所 示 。 如 果 收 到 一 条 短信 和 则 会 显示 提示 信息 ， 并 自动 生成 
条 邮件 提示 ， 如 图 12-2 所 示 。 
在 模拟 器 中 也 可 以 运行 本 项 目 ,方法 是 在 Eclipse 中 打开 DDMS 面板 ,在 Telephony Actions 
中 设置 手机 号 码 和 短信 内 容 ， 并 单 击 Send 按钮 ， 如 图 12-3 所 示 。 
o> El 


等 待 中 … 等 待 中 .… 


收 到 短信 ! 


图 12-1 初始 运行 效果 图 12-2 rail AT 


Em 
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$ Threads ` (g Heap @ Allocation Tracker Network Statistics ($8: File Explorer Emulator Control 22 | [7] System Information = al 


[Telephony Status 


Voice: [home T| Speed: [Full 已 
Data: [home | Latency: [None = 


[Telephony Actions 


Incoming number: |15069073006 


C Voice 


C sus 
Message: 


Location Controls 
Nawal le jo | 
G Decimal 
C. Sexagesimal 
Longitude [-122. 084095 ` 


Latitude |3T. 422006 


E51 


图 12-3 Eclipse DI DDMS 面板 


12.1.2 (+p SmsManager 收发 邮件 

在 Android 系统 中 ， 除 了 可 以 使 用 Intent 调用 内 置 邮件 系统 发 送 邮 件 外 ， 还 可 以 使 用 类 
SmsManager 来 收发 邮件 。 在 Android 平台 中 ， 类 SmsManager 是 用 来 管理 短信 服务 操作 ， 像 
发 送 数据 、 文 本 和 数据 单元 等 短信 服务 消息 。 可 以 通过 调用 SmsManager.getDefault()?K 3X EX 


SmsManager 对 象 。 

1. 常量 

口 public static final int RESULT ERROR GENERIC FAILURE: 表示 普通 错误 ， 值 为 
1(0x00000001). 

C] public static final int RESULT ERROR NO SERVICE: 表示 当前 服务 不 可 用 ， 值 为 4 
(0x00000004)。 

C] public static final int RESULT ERROR NULL PDU: 表示 没有 提供 pdu， 值 为 3 
(0x00000003). 


口 public static final int RESULT ERROR RADIO OFF: 表示 无 线 广播 被 明确 地 关闭 ， 值 
为 2 (0x00000002)。 

口 public static final int STATUS ON ICC FREE: 表示 自由 空间 ， 值 为 0 (0x00000000). 
C] public static final int STATUS ON ICC READ: 表示 接收 且 已 读 , 值 为 1 (0x00000001)。 


口 public static final int STATUS ON ICC SENT: 表示 存储 且 已 发 送 ， 值 为 5 
(0x00000005). 

Q public static final int STATUS ON ICC UNREAD: 表示 接收 但 未 读 ， 值 为 3 
(0x00000003). 

O public static final int STATUS ON ICC UNSENT: 表示 存储 但 未 发 送 ， 值 为 7 
(0x00000007)。 


2. 公有 方法 

(1) ArrayList<String> divideMessage(String text) 

功能 : 当 短 信 超 过 SMS 消息 的 最 大 长 度 时 ， 将 短信 分 割 为 几 块 。 
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参数 text: 初始 的 消息 ， 不 能 为 空 。 


返回 值 ， 有 序 的 ArrayList<String>， 可 以 重新 组 合 为 初始 的 消息 。 


(2) static S 


msManager getDefault() 


功能 : 获取 SmsManager 的 默认 实例 。 
SmsManager 的 默认 实例 。 

(3) void SendDataMessage(String destinationAddress, String scAddress, short destinationPort, 
byte[] data, PendingIntent sentIntent, PendingIntent deliveryIntent) 


功能 : 发 送 一 个 基于 SMS 的 数据 到 指定 的 应 用 程序 端口 。 


返回 值 : 


参数 介绍 


OOooo 


如 下 。 


destinationAddress: 消息 的 目标 地 址 。 

scAddress: 服务 中 心 的 地 址 或 为 衬 ， 则 使 用 当前 默认 的 SMSC. 

destinationPort: 消息 的 目标 端口 号 。 

data: 消息 的 主体 ， 即 消息 要 发 送 的 数据 。 

sentIntent: 如 果 不 为 空 ， 当 消息 成 功 发 送 或 失败 ， 这 个 PendingIntent 就 广播 。 结 果 代 


码 是 Activity.RESULT_OK 表示 成 功 ， 或 为 RESULT_ERROR GENERIC FAILURE, 
RESULT ERROR RADIO OFF, RESULT ERROR NULL PDU 之 一 则 表示 错误 。 当 
Jj RESULT ERROR GENERIC FAILURE 时 , sentIntent 可 能 包括 额外 的 “错误 代码 ”， 


例如 通常 包含 一 个 无 线 电 广播 技术 特定 的 值 ， 这 只 在 修复 故障 时 有 用 。 每 一 个 基于 


SMS ff 


4 应 用 程 
应 用 程序 ， 


ATM sentIntent. WE sentIntent 是 空 ， 调 用 者 将 检测 所 有 未 知 的 


Eds 


这 将 导致 在 检测 的 时 候 发 送 较 小 数量 的 SMS。 
O deliveryIntent: 如 果 不 为 空 ， 当 消息 成 功 传送 到 接收 者 ， 这 个 PendingIntent 就 广播 。 


异常 : 如果 destinationAddress 或 data 为 空 时 ， 抛 出 IllegalArgumentException 异常 。 

(4) void sendMultipartTextMessage(String destinationAddress, String scAddress, ArrayList 
«String» parts, ArrayList<PendingIntent> sentIntents, ArrayList<PendingIntent> — deliverIntents) 

功能 : 发 送 一 个 基于 SMS 的 多 部 分 的 文本 ， 调 用 者 通过 调用 divideMessage(String text) 


将 消息 分 制 成 
参数 介绍 


C] destinationAddress: 消息 的 目标 地 址 。 


如 下 。 


正确 的 大 小 。 


口 scAddress: 服务 中 心 的 地 址 ， 为 空 则 使 用 当前 默认 的 SMSC. 
口 parts: 有 序 的 ArrayList<String>， 可 以 重新 组 合 为 初始 的 消息 。 
口 sentIntents: 是 一 组 PendingIntent。 


my 


O deliverIntents: 是 一 组 PendingIntent。 

异常 :， 如果 destinationAddress 或 data 为 空 时 ， 抛 出 IllegalArgumentException 异常 。 

(5) void sendTextMessage(String destinationAddress, String scAddress, String text, Pending 
Intent sentIntent, PendingIntent deliveryIntent) 


功能 : 发 送 一 个 基于 SMS 的 文本 。 BA MA ae E BU TEL 4 SAA HIE AE, 


在 此 不 再 累 述 。 


在 下 面 的 实例 中 定义 了 两 个 EditText 控件 ， 分 别 用 于 获取 收 信人 电话 和 短信 正文 ， 并 设 
置 了 判断 手机 号 码 规范 化 的 方法 ， 并 且 设 置 了 短信 的 字数 不 超过 70 个 字符 。 本 实例 通过 
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值 
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达 服 务 PendingIntent。 


Pp 要 传 入 5 个 


分 别 是 : 收 件 人 地 址 String、 发 送 地 址 String、 正 文 String、 发 送 服务 PendingIntent 和 送 


实例 7 


实例 12-2 使 用 SmsManager 实现 一 个 邮件 发 送 程序 


daima\12\jiandan 


本 实例 的 具体 实现 流程 如 下 。 
CL) 编写 布局 文件 main.xml， 主 要 代码 如 下 。 


<TextView 
android:id="(@+id/widget27" 


android:layout_width 


android:layout_height 


android:text="@string/str_textview" 


android:textSize="16sp" 
android:layout_x="0px" 
android:layout_y="12px" 

> 

</TextView> 

<EditText 
android:id="@-+id/myEditText1" 


android:layout_width="fill_parent" 


android:layout_height="wrap_content" 


android:text="" 
android:textSize="18sp" 
android:layout_x="60px" 
android:layout_y="2px" 

> 

</EditText> 

<EditText 
android:id="@+id/myEditText2" 


android:layout_width="fill_parent" 


android:layout_height="223px" 
android:text="" 
android:textSize="18sp" 
android:layout_x="0px" 
android:layout_y="52px" 

> 

</EditText> 

<Button 
android:id="@+id/myButton1" 
android:layout_width="162px" 


android:layout_height="wrap_content" 
android:text="@string/str_button1" 


android:layout_x="80px" 


wrap_content" 


wrap_content" 
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android:layout_y="302px" 
> 


</Button> 


(2) 编写 主 程序 文件 jiandan.java， 声 明 一 个 Button 和 两 个 EditText，EditText 供 获取 输入 
收 信人 电话 号 码 和 短信 内 容 ，Button 按钮 用 于 激活 发 信 处 理 程序 。 通 过 方法 PendingIntent. 
getBroadcast() 自 定义 了 PendingIntent 并 进行 了 Broadcast 广播 ， 然 后 使 用 SmsManager. 
getDefaultO 预 先 构建 的 SmsManager 对 象 , 使 用 sendTextMessage() 方 法 将 有 关 的 数据 以 参数 形 
式 带 入 ， 这 样 即 可 完成 发 短信 的 任务 。 文 件 jiandan.java 的 具体 代码 如 下 。 


public class jiandan extends Activity 
{ 
人/# 声 明 变 量 一 个 Button 与 两 个 EditText*/ 
private Button mButton1; 
private EditText mEditText1; 
private EditText mEditText2; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate(Bundle savedInstanceState) 


1 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 

/* 

* 通过 findViewByld 构造 器 来 建构 

* EditTextl,EditText2 与 Button XJ 

St 

mkEditText1 = (EditText) find ViewByld(R.id.myEditText1); 
mEditText2 = (EditText) find ViewByld(R.id.myEditText2); 
mButtonl = (Button) findViewById(R.id.myButton1); 
It, FINZ EditText 中 */ 

mEditText1 set Text(" W 48) AN Ki 15"); 

mEditText2.setText(" i548) A. UN £11"); 

Y t onClickListener 让 用 户 单 击 EditText 时 做 出 反应 */ 
mkEditText1 .setOnClickListener(new EditText.OnClickListener() 


{ 
public void onClick(View v) 


1 
/# 单 击 EditText 时 清空 正文 */ 
mEditText1.setText(""); 
j 
j 
» 
JEE onClickListener 让 用 户 单 击 EditText 时 做 出 反应 */ 
mEditText2.setOnClickListener(new EditText.OnClickListener() 


1 
public void onClick(View v) 
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} 
} 
X 


/* 单 击 EditText 时 清空 正文 */ 
mEditText2.setText(""); 


[x & onClickListener 让 用 户 单 击 Button 时 做 出 反应 */ 
mButton1.setOnClickListener(new Button.OnClickListener() 


1 


@Override 
public void onClick(View v) 


1 


/* 


EditTextl 取得 短信 收 件 人 


/* 


Wien 
String strDestAddress = mEditText1.getText().toString(); 
EditText2 取得 短信 文字 内 容 */ 


String strMessage = mEditText2.getText().toString(); 
人 建构 一 取得 default instance 的 SmsManager 对 象 */ 
SmsManager smsManager = SmsManager.getDefault(); 


// TODO Auto-generated method stub 


PRT ero A Hs FX s RH E RUE PL 70 字符 */ 
if(isPhoneNumberValid(strDestAddress)==true && 


j 


C 


1 
j 


iswithin70(strMessage) ==true) 


ek 


* 两 个 条 件 都 检查 通过 的 情况 ] 
* 先 建 构 一 PendingIntent 对 象 


F ,发送 短信 


使 用 getBroadcastO 广 播 


* 将 PendingIntent, 


Hin, Mitr PGB 


* ft  sendTextMessage() 7712: / 35 Rd a 


v 


PendingIntent mPI = PendingIntent.getBroadcast 


(jiandan.this, 0, new Intent(), 0); 
smsManager.sendTextMessage 


(strDestAddress, null, strMessage, mPI, null); 


atch(Exception e) 


e.printStackTrace(); 


Toast.makeText 


( 


) 


jiandan.this," 送 出 成 功 !1" ， 
Toast.LENGTH SHORT 
.Show(); 


mEditTextl.setText(""); 
mEditText2.setText(""); 


第 12 章 开发 电子 邮件 应 用 程序 


j 


else 
{ 
[* 电话 格式 与 短信 文学 不 符合 条 件 时 ,以 Toast 提醒 */ 
if (isPhoneNumberValid(strDestAddress) ==false) 
1 EFZG 70 字符 */ 
if(iswithin70(strMessage) ==false) 
{ 
Toast.makeText 
( 
jiandan.this, 
"电话 号 码 格式 错误 + 短信 内 容 超 过 70 "rS eur, 
Toast.LENGTH SHORT 
).show(); 
j 
else 
{ 


Toast.makeText 


( 
jiandan.this, 
"电话 号 码 格式 错误 ,请 检查 !!"， 
Toast.LENGTH SHORT 
).show(); 


j 


} 
[GERE T0 字符 */ 
else if (iswithin70(strMessage) ==false) 


{ 
Toast.makeText 
( 
jiandan.this, 
"短信 内 容 超过 70 字 , 请 删除 部 分 内 容 !!"， 
Toast.LENGTH SHORT 
).show(); 
} 
} 
j 
Ei 
j 


PRY BS PAE EB A v SAS 77 E FF [EI true or false 的 判断 值 */ 
public static boolean isPhoneNumberValid(String phoneNumber) 
1 

boolean isValid — false; 

入 可 接受 的 电话 格式 有 : 

*^wQ : 可 以 使 用 "C 作为 开头 

* (\\d{3}): 紧 接着 三 个 数字 

* wm : 可 以 使 用 ")" 接 续 
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*[-]2: 在 上 述 格式 后 可 以 使 用 具 选 择 性 的 "-". 
* (Nd{3}) : 再 紧 接着 三 个 数字 
*x[-]? : 可 以 使 用 有 具 选择 性 的 "-" 接续 . 
* (\d{5})$: 以 五 个 数字 结束 . 
* 可 以 比较 下 列 数字 格式 : 
* (123)456-7890, 123-456-7890, 1234567890, (123)-456-7890 
of} 
String expression = 
"^NQQWd )W?[- J2M\d {3} )L- Pd {5} )8"5 
入 可 接受 的 电话 格式 有 : 
*^wQ : 可 以 使 用 "(” 作 为 开头 
* (d): 紧 接 着 三 个 数字 
zum: ur EU mes 
*[-T? : 在 上 述 格式 后 可 以 使 用 具 选 择 性 的 "-". 
* (Qd(4) : 再 紧 接着 四 个 数字 
* [-]? : 可 以 使 用 具 选 择 性 的 "-" 接续 . 
*(\\d{4})$: 以 四 个 数字 结束 . 
* 可 以 比较 下 列 数字 格式 : 
* (02)3456-7890, 02-3456-7890, 0234567890, (02)-3456-7890 
=f 
String expression2= 
"^NQQW DV- PON 4} )L- PO {4} )$"5 
CharSequence inputStr = phoneNumber; 
/*G]£& Pattern*/ 
Pattern pattern = Pattern.compile(expression); 
/* 将 Pattern 以 参数 传 入 Matcher 作 Regular expression*/ 
Matcher matcher = pattern.matcher(inputStr); 
/* 0] Æ Pattern2*/ 
Pattern pattern2 =Pattern.compile(expression2); 
/*#% Pattern2 以 参数 传 入 Matcher? 作 Regular expression*/ 
Matcher matcher2= pattern2.matcher(inputStr); 


y 


* 


* 


if(matcher.matches()||matcher2.matches()) 


{ 
isValid = true; 

} 

return is Valid; 
} 
public static boolean iswithin70(String text) 
{ 

if (text.length) <= 70) 

{ 


return true; 


j 


else 


1 


return false; 


j 
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j 


(3) 最 后 编写 文件 AndroidManifestxml， 向 系统 注册 一 个 常 驻 的 BroadcastReseiver， 并 设置 
这 个 Reseiver 的 intent-filter， 让 其 SMSreceiver 针对 收 到 短信 事件 做 出 反应 ， 并 声明 
android.permission RECEIVE SMS 权限 。 文 件 AndroidManifest.xml 的 具体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="irdc.tong" 
android:versionCode="1" 
android:versionName="1.0.0"> 
«application android:icon="@drawable/icon" android:label="@string/app_name"> 
«activity android:name="irdc.tong.tong" 
android:label="@string/app_name"> 
<intent-filter> 
«action android:name="android.intent.action. MAIN" /> 
«category android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
<!-- 建立 receiver 来 聆听 系统 广播 信息 -> 
«receiver android:name="irdc.tong.SMSreceiver"> 
<!-- 设置 要 捕捉 的 信息 名 是 provider 中 Telephony.SMS_ RECEIVED --> 
<intent-filter> 


<action 
android:name="android.provider.Telephony.SMS RECEIVED" /> 
</intent-filter> 
</receiver> 
</application> 
<uses-permission android:name="android.permission.RECEIVE_SMS"></uses-permission> 


</manifest> 


执行 后 的 效果 如 图 12-4 所 示 ， 和 输入 手机 号 码 ， 编 写 短信 内 容 后 ， 单 击 “ 发 送 ”按钮 后 即 
可 完成 短信 发 送 功能 ， 系 统 会 提示 发 送 成 功 信息 ， 如 图 12-5 所 示 。 


| 请 输入 号 码 


请 输入 内 容 !! 


SS 


图 12-4 初始 效果 图 12-5 发 送 成 功 
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如 果 短 信 内 容 和 收 信 人 号 码 格式 不 规范 ， 


12.2 ”向 本 地 联系 人 发 送 邮 件 


在 下 面 的 实例 中 , 利用 Android 提供 的 Intent 接口 实现 邮件 发 送 功能 。 在 发 送 邮 件 功 能 中 ， 


会 输出 对 应 的 错误 提示 。 


使 用 了 Intent 行为 android.content.Intent.ACTION_SEND。 在 本 实例 中 ， 使 用 的 邮件 发 送 服务 


是 调用 Gmail 程序 ， 而 并 不 是 直接 使 用 SMTP 协议 。 本 实例 实现 了 如 下 的 功能 。 
OQ 验证 用 户 输入 是 否 为 正确 的 邮箱 格式 。 
C) 使 用 者 既 可 以 手动 输入 邮箱 ， 也 可 以 长 按 邮箱 文本 框 跳 到 联系 人 那里 找到 联系 人 ， 得 
到 联系 人 的 邮箱 后 返回 。 
口 发 送 邮件 。 
实例 x 能 源码 路 径 
实例 12-3 向 本 地 联系 人 发 送 邮件 daima\12\sendE-mail 


在 接 下 来 的 内 容 中 ， 将 详细 
12.21 界面 布局 


解 本 实例 的 


EP 


和 邮件 内 容 信息 ， 


<?xml version="1.0" encoding="utf-8"?> 

<AbsoluteLayout 
android:id="(@+id/widget34" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
android:background="@drawable/white" 


写 布局 文件 main.xml， 分 别提 供 了 4 个 EditText KH 
并 通过 Button 控件 提供 一 个 发 送 按钮 。 文 


基体 实现 过 程 。 


Ire A Jr 
TE main.xml 的 


和 牛人、 附件、 主题 


4 


~ 


体 实现 代码 如 下 。 


xmlns:android="http://schemas.android.com/apk/res/android" 


> 

<TextView 
android:id="@-+id/myTextView1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/str_receive" 
android:layout_x="60px" 
android:layout_y="22px" 

> 

</TextView> 

<TextView 
android:id="@-+id/myTextView2" 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"(g)string/str cc" 


android:layout_x="60px" 
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android:layout_y="82px" 

> 

</TextView> 

<EditText 
android:id="(@-+id/myEditText1" 
android:layout width-"fill parent" 


android:layout height-"wrap content" 
android:textSize-"18sp" 
android:layout_x="120px" 
android:layout_y="12px" 

> 

</EditText> 

<EditText 
android:id="(@-+id/myEditText2" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:textSize-"18sp" 
android:layout_x="120px" 
android:layout_y="72px" 

> 

</EditText> 

<Button 
android:id="@-+id/myButton 1" 


e 


android:layout width-"wrap content" 
android:layout height-"124px" 
android:text-"(Q)string/str button" 
android:layout_x="0px" 
android:layout_y="2px" 

> 

</Button> 

<TextView 
android:id="@-+id/myTextView3" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"(g)string/str subject" 
android:layout_x="60px" 
android:layout_y="142px" 

> 

</TextView> 

<EditText 
android:id="@-+id/myEditText3" 
android:layout_width="fill_parent" 


android:layout height-"wrap content" 
android:textSize-"18sp" 
android:layout_x="120px" 


android:layout_y="132px" 
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12.2.2 


> 
</EditText> 
<EditText 


android:id="@-+id/myEditText4" 
android:layout_width="fill_parent" 
android:layout_height="209px" 
android:textSize="18sp" 
android:layout_x="0px" 
android:layout_y="202px" 


> 


</EditText> 


</AbsoluteLayout> 


编写 主 程序 文件 


C) 通过 函数 isEmail0 验 证 邮箱 格式 是 否 正 确 。 


序 文件 sendE-mailActivity.java, 


具体 实现 过 程 如 下 。 


O 当 从 一 个 Activity 跳 转 到 另 一 个 Activity 时 ， 为 了 实现 得 到 需要 的 数据 后 返回 到 原 有 


口 


360 HH 


requestCode 为 一 个 Activity 要 返回 日 


的 Activitiy 所 在 的 控件 上 ， 上 述 跳 转 功能 都 需要 1 
想 实现 跳 转 并 取 值 返回 ， 就 需要 用 到 startActivityForResult(intent,requestCode), JL A 
的 值 的 依据 ， 可 以 为 任意 的 int 类 型 。 


助 于 StartAcivity0 方 法 实现 。 如 果 


可 以 自己 定 


义 常量 , 也 可 以 自己 指定 数字 ,程序 覆盖 了 onActivityResult0 这 个 方法 , 程序 收 到 result 


后 ， 


即 自行 跳 转 到 联系 人 页 面 上 ， 


重新 写 回 原本 需要 加 载 的 控件 上 。 本 例 ， 


主 程序 窗口 3 


法 ， 


了 一 些 Content Provider， 用 于 处 理 
系 信息 等 。 虽然 可 以 从 Provider 包 
Content Provider 如 何 存储 数据 ， 坟 
Content Provider 必须 实现 一 利 
一 个 Content Provider RER SKILA XH 
据 的 存储 /检索 更 加 
实现 邮件 发 送 处 理 。 


通过 OnLongClickListener 


加 载 到 文本 上 


单 击 需要 的 联系 人 名 称 ， 则 返回 该 联系 人 的 | 


searhE-mail 事件 处 理 程序 ， 用 户 长 按 文本 框 后 会 通过 
Content Provider 查找 并 跳 转 到 联系 人 中 心 ， 查 找 用 户 并 返回 邮箱 。 如 果 要 公开 设备 
的 联系 信息 数据 ， 可 以 创建 或 者 使 月 


有 一 个 Content Provider. Content Provider 是 


i 


这 是 因为 不 存在 那 种 供 所 有 


it) oe 


简单 。 


mm 


在 EditText. Button 控件 中 通过 构造 


调 了 文本 框 的 长 按 事件 ， 文 本 框 长 按 
b 箱 号 回 到 


ei 


L 


Gr 


or 


使 所 有 应 用 程度 都 能 被 存储 和 检索 数据 的 对 象 ， 是 唯一 在 包 和 包 之 间 分 享 数据 的 方 
Lon: 
般 的 数据 类 型 ， 例 如 音频 、 视 频 、 图 片 和 个 人 联 
看 到 一 些 Android 自 带 的 Content Provider, 但 是 
AE FIX Content Provider 如 何 实 现 。 但 是 所 有 的 
的 约定 规则 , 才能 实现 数据 查询 
的 方法 ,使 得 在 处 理 一 些 特定 的 数据 时 , 对 于 数 


Ht 


般 存储 空间 。 在 Android 系统 中 


返回 结果 。 然而， 


个 自 


定义 的 Intent 


(android.content.Intent.ACTION_SEND) 作为 传送 E-Mail 的 Activity。 在 这 个 Intent 


中 还 必须 使 月 


] setIypeQ2K Zt cE E-Mail 的 格式 ， 使 用 putExtra() 来 置 入 寄 件 人 
(EXTRA E-MAIL), di CEXTRA SUBJECT), 


p 件 内 容 (EXTRA TEXT) UKH 


他 E-Mail 的 字段 (CEXTRA_BCC, EXTRA CC). 


XH 
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F sendE-mailActivity.java 的 具体 实现 代码 如 下 。 


public class sendE-mailActivity extends Activity { 
private Button myButton; 
private EditText myEditText; 
private EditText myEditText2; 
private EditText myEditText3; 
private EditText myEditText4; 
private String[] strE-mailReciver; 
private String strE-mailSubject; 
private String[] strE-mailCC; 
private String strE-mailBody; 
private static final int DICK CONTACT SUBACTIVITY = 2; 


public void onCreate(Bundle savedInstanceState) { 

super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
myButton-(Button)findViewById(R.id.myButtonl); 
myEditText=(EditText)findViewByld(R.id.myEditText1); 
myEditText2=(EditText)find ViewByld(R.id.myEditText2); 
myEditText3-(EditText)findViewById(R.id.myEditText3); 
myEditText4-(EditText)find ViewByld(R.id.myEditText4); 
myButton.setEnabled(false); 
myEditText.setOnLongClickListener(searhE-mail); 
myButton.setOnClickListener(new OnClickListener() { 

@Override 

public void onClick(View v) { 


Intent mailIntent-new Intent(android.content.Intent ACTION SEND); 
mailIntent.setType("plain/test"); 

strE-mailReciver-new String[] ( myEditText.getText().toString() }; 
strE-mailCC=new String[]{myEditText2.getText().toString()}; 
strE-mailSubject=myEditText3.getText().toString(); 
strE-mailBody=myEditText4.getText().toString(); 
mailIntent.putExtra(android.content.Intent EXTRA E-MAIL, strE-mailReciver); 
mailIntent.putExtra(android.content.Intent. EXTRA CC, strE-mailCC); 
mailIntent.putExtra(android.content.Intent. EXTRA SUBJECT, strE-mailSubject); 
mailIntent.putExtra(android.content.Intent. EXTRA TEXT, strE-mailBody); 


startActivity(Intent.createChooser(mailIntent, getResources().getString (R.string.send))); 
第 二 种 方法 

Uri uri=Uri.parse("mailto:terryyhl@gmail.com"); 

Intent MymailIntent-new Intent(Intent. ACTION _SEND,uri); 
startActivity(MymailIntent); 


[* 第 三 种 方法 
Intent testintent=new Intent(Intent. ACTION SEND); 
String[] tos={"terryyhl@gmail.com"}; 
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String[] ccs={"kalaicheng@hotmail.com"}; 
testintent.putExtra(Intent. EXTRA E-MAIL, tos); 
testintent.putExtra(Intent. EXTRA CC ccs); 
testintent.putExtra(Inten.EXTRA TEXT, "这 是 内 容 "); 
testintent.putExtra(Intent. EXTRA_SUBJECT, "这 是 标题 "); 
testintent.setType("message/rfc822"); 
startActivity(Intent.createChooser(testintent, "发 送 ")); 


=i] 
/* 
PBR TT, bit 
Intent testN=new Intent(Intent. ACTION SEND); 
testN.putExtra(Intent EXTRA SUBJECT, "标题 "); 
testN.putExtra(Intent. EXTRA STREAM, "file:///sdcard/music.mp3"); 
startActivity(Intent.createChooser(testN, "发 送 ")); 
E 
j 
» 


myEditText.setOnKeyListener(new OnKeyListener() ( 
@Override 
public boolean onKey(View v, int keyCode, KeyEvent event) { 
// TODO Auto-generated method stub 
if(isE-mail(myEditText.getText().toString())) 


{ 

myButton.setEnabled(true); 
} 
else 
{ 

myButton.setEnabled(false); 
} 
return false; 


= 一 


» 
} 
/ 检查 E-Mail 格式 
public static boolean isE-mail(String strE-mail) { 
String strPattern 


"\Ta-zA-Z][\\w\\.-]*[a-zA-Z0-9]@[a-zA-Z0-9][\\w\\.-]*[a-zA-Z0-9]\.[a-zA-Z]fa-zA-Z\.]*[a-zA-Z]$"; 
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Pattern p — Pattern.compile(strPattern); 
Matcher m = p.matcher(strE-mail); 
return m.matches(); 
j 
private OnLongClickListener searhE-mail-new OnLongClickListener() ( 
public boolean onLongClick(View arg) { 


第 12 章 天 发 电子 邮件 应 用 程序 


Uri uri-Uri.parse("content://contacts/people"); 
Intent intent=new Intent(Intent. ACTION PICK, uri); 
startActivityForResult(intent, PICK CONTACT SUBACTIVITY); 
return false; 
} 
5 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
switch (requestCode) { 
case PICK CONTACT SUBACTIVITY: 
final Uri uriRet=data.getData(); 
if(uriRet!=null) 
{ 
try { 
Cursor c=managedQuery(uriRet, null, null, null, null); 
c.moveToFirst(); 


/取得 联系 人 的 姓名 


String strName-c.getString(c.getColumnIndexOrThrow(People.NAME)); 


/取得 联系 人 的 E-Mail 
String[] PROJECTION=new String[] 
Contacts.ContactMethods. ID, 
Contacts.ContactMethods.K IND, 
Contacts.ContactMethods.DATA 
L 
I £t VIR xe ALTI E-Mail 
Cursor newcur-managedQuery( 
Contacts.ContactMethods. CONTENT URI, 
PROJECTION, 
Contacts.ContactMethods.PERSON_ID+"=\" 
+c.getLong(c.getColumnIndex(People._ID))+"\"" 
null, null); 
startManagingCursor(newcur); 
String E-mail=""; 
if(newcur.moveToFirst()) 
{ 
E-mail=newcur.getString(newcur.getColumnIndex 
(Contacts.ContactMethods.DATA)); 
myEditText.setText(E-mail); 
} 
} catch (Exception e) { 
// TODO: handle exception 


Toast.makeText(sendE-mailActivity.this, e.toString(), 1000).show(); 


j 


break; 
default: 
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break; 


} 
super.onActivityResult(requestCode, resultCode, data); 


E 


在 上 述 实现 代码 中 ， 还 演示 了 在 Android 系统 中 发 送 E-Mail 的 其 他 方法 : 
O 方法 1: 使 用 parse 方法 。 


ay 


Uri uri=Uri.parse("mailto:terryyhl@gmail.com"); 
Intent MymailIntent-new Intent(Intent. ACTION SEND, uri); 
startActivity(MymailIntent); 


O 方法 2: 使 用 Intent 创建 新 界面 。 


Intent testintent=new Intent(Intent ACTION SEND); 
String[] tos={"terryyhl@gmail.com"}; 

String[] ccs={"kalaicheng@hotmail.com"}; 
testintent.putExtra(Intent. EXTRA E-MAIL, tos); 
testintent.putExtra(Intent.EXTRA CC, ccs); 
testintent.putExtra(Intent.EXTRA TEXT, "这 是 内 容 "); 
testintent.putExtra(Intent.EXTRA_SUBJECT, "这 是 标题 "); 
testintent.setType("message/rfc822"); 
startActivity(Intent.createChooser(testintent, "发 送 ")); 


FP 的 音乐 文件 作为 附件 发 送 。 


Intent testN=new Intent(Intent. ACTION SEND); 
testN.putExtra(Intent. EXTRA SUBJECT, "标题 "); 
testN.putExtra(Intent EXTRA STREAM, "file:///sdcard/music.mp3"); 
startActivity(Intent.createChooser(testN, "发 送 ")); 


et 


O 方法 3: 将 SD 卡 


本 实例 执行 后 的 效果 如 图 12-6 所 示 。 


图 12-6 执行 效果 
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经 过 本 书 前 面 内 容 的 学 习 ，Android 网 络 开发 技术 已 经 讲解 结束 。 在 本 章 的 内 容 中 ,将 详 
细 介 绍 Android 在 网 络 领域 的 常用 模块 ， 不 但 探讨 了 新 技术 ， 而 且 对 前 面 的 内 容 进行 整体 回 
顾 ， 以 稳固 所 学 知识 。 


13.1 测试 网 络 下 载 速度 


用 户 一 般 比较 关心 网 速 的 问题 ， 大 家 都 不 喜欢 过 慢 的 下 载 速度 。 所 以 在 Anroid 平台 中 ， 
很 有 必要 开发 一 个 网 速 测试 程序 。 在 接 下 来 的 演示 代码 中 ， 将 通过 下 载 文件 的 大 小 和 当前 读 
取 的 字 市 数 ， 在 固定 的 时 间 内 检测 网 络 速度 。 

CD 首先 定义 网 络 信息 类 NetWorkSpeedInfo， 在 里 面 设置 了 需要 的 常量 值 。 


packagecc.androidos.speed; 

publicclassNetWorkSpeedInfo 

1 
/** 网 速 */ 
publiclongspeed=0; 
PESE SE 站 光 
publiclonghadFinishedBytes=0; 
POS AEE Khan 
publiclongtotalBytes=1024; 
AWARA, 3G/GSM*/ 
publicintnetworkType=0; 
/si* 下载 进度 0----100*/ 
publicintdownloadPercent=0; 


} 


(2) 开始 编写 一 个 名 为 SpeedActivity 的 主 Activity， 获 取 网 络 速度 。 


packagecc.androidos.speed; 
importandroid.app.Activity; 
importandroid. graphics.Bitmap; 
importandroid.graphics. BitmapFactory; 
importandroid.os.Bundle; 
importandroid.os.Handler; 
importandroid.os.Message; 
importandroid.util.Log; 
importandroid.view. View; 
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importandroid.widget.Button; 
importandroid.widget.ImageView; 
importandroid.widget.TextView; 
publicclassSpeedActivityextendsActivity 
1 

TextViewfileLength-null; 
TextViewspeed-null; 
TextViewhasDown=null; 
TextViewpercent=null; 
Stringurl=""; 

ImageViewimageView=null; 

byte[]imageData=null; 
NetWorkSpeedInfonetWorkSpeedInfo-null; 
privatefinalint UPDATE SPEED-1; 

@Override 

publicvoidonCreate(BundlesavedInstanceS tate) 

1 

super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
hasDown-(TextView)findViewById(R.id.hasDown); 
fileLength-(TextView)findViewById(R.id.fileLength); 
speed=(TextView)find ViewByld(R.id.speed); 
percent=(TextView)findViewById(R.id.percent); 
image View=(ImageView)find ViewByld(R.id. Image View01); 
Buttonb=(Button)findViewByld(R.id.Button01); 
url-getString(R.string.image url); 
netWorkSpeedInfo=newNetWorkSpeedInfo(); 
b.setOnClickListener(new View.OnClickListener() 

1 

@Override 

publicvoidonClick(Viewarg0) 

1 

/下 载 文件 线程 

new Thread() 

{ 

@Override 

publicvoidrun() 

{ 

imageData=ReadFile.getFileFromUrl(url, 
netWorkSpeedInfo); 

stop(); 

} 

} start(); 

/获取 速度 ， 加 载 字 节 ， 更 新 视图 线程 

new Thread() 

1 
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@Override 

publicvoidrun() 

{ 
while(netWorkSpeedInfo.hadFinishedBytes«netWorkSpeedInfo.total Bytes) 
{ 
netWorkSpeedInfo.downloadPercent=(int)(((double)netWorkSpeedInfo.hadFinishedBytes/ 
(double)netW orkSpeedInfo.totalBytes)* 100); 

try 

{ 

sleep(1500); 

j 

catch(InterruptedExceptione) 

{ 

e.printStackTrace(); 

j 

Log.e("update,sendthemessagetoupdate",""); 
handler.sendEmptyMessage(UPDATE SPEED); 
j 

/已 经 完成 的 
if(netWorkSpeedInfo.hadFinishedBytes==netWorkSpeedInfo.totalBytes) 
{ 
netWorkSpeedInfo.downloadPercent=(int)(((double)netWorkSpeedInfo.hadFinishedBytes/ 
(double)netW orkSpeedInfo.totalBytes)* 100); 
handler.sendEmptyMessage(UPDATE SPEED); 
Log.e("update", 

" sendthemessagetoupdateandstop"); 

stop(); 

j 

j 

} start(); 

j 

D 

j 

privateHandlerhandler-newHandler() 

{ 

@Override 
publicvoidhandleMessage(Messagemsg) 

{ 

intvalue-msg. what; 

switch(value) 

{ 

caseUPDATE SPEED: 

updateView(); 

break; 

default: 

break; 
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} 

} 

Dr 

privatevoidupdateView() 

{ 

speed.setText(netWorkSpeedInfo.speed+"bytes/s"); 
hasDown.setText(netWorkSpeedInfo.hadFinishedBytes+"bytes"); 
fileLength.setText(netW orkSpeedInfo.totalBytes--""); 
percent.setText(netWorkSpeedInfo.downloadPercent--"96"); 
if(imageData!=null) 

{ 

Bitmapb=BitmapFactory.decodeByteArray(imageData,0, 
imageData. length); 

imageView.setImageBitmap(b); 

} 

} 

j 


(3) 编写 读 取 指定 Web 文件 的 代码 ， 用 于 通过 读 取 这 个 指定 的 文件 来 测试 速度 。 


packagecc.androidos.speed; 
importjava.io.InputStream; 
importjava.net. URL; 
importjava.net. URL Connection; 
importandroid.util.Log; 
publicclassReadFil ( 
publicstaticbyte[]getFileFromUrl(Stringurl,NetWorkSpeedInfonetWorkSpeedInfo) 
1 

intcurrentByte=0; 

intfileLength=0; 

longstartTime=0; 
longintervalTime=0; 

byte[ ]b=null; 

intbytecount=0; 

URLurlx=null; 
URLConnectioncon=null; 
InputStreamstream=null; 

tri 

Log.d("URL:",url); 
urlx=newURL(rl); 
con=urlx.openConnection(); 
con.setConnectTimeout(20000); 
con.setReadTimeout(20000); 
fileLength=con. getContentLength(); 
stream-con.getInputStream(); 
netWorkSpeedInfo.totalBytes=fileLength; 
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b-newbyte[fileLength ]; 

start 'ime-System.currentTimeMillis(); 
while((currentByte-stream.read())!—-1) 
1 
netWorkSpeedInfo.hadFinishedBytes++; 
intervalTime-System.currentTimeMillis()-startTime; 
if(intervalTime- —0) { 
netWorkSpeedInfo.speed-1 000; 

yelse { 
netWorkSpeedInfo.speed=(netWorkSpeedInfo.hadFinishedBytes/intervalTime)*1000; 
j 

if(bytecount<fileLength) ( 
b[bytecount++ |=(byte)currentByte; 

j 

j 

j 

catch(Exceptione) 

{ 
Log.e("exception:",e.getMessage()+""); 
j 

finall { 

tr{ 

if(stream!=null) 

{ 

stream.close(); 

j 

j 

catch(Exceptione) 

1 

Log.e("exception:",e.getMessage()); 

j 

j 

returnb; 

j 

j 


通过 Hander 实现 异步 消息 处 理 


在 Android 系统 中 ， 可 以 与 服务 器 端 实现 HTTP 通信 ， 并 解析 XML 数据 ， 通 过 Handler 
实现 异步 消息 处 理 。 在 接 下 来 的 演示 代码 中 ， 分 别 实现 了 如 下 三 个 重要 操作 。 


(1) 
(2) 
(3) 


HTTP 通信 : 与 服务 器 端 做 HTTP 通信 ， 分 别 以 GET 方式 和 了 POST 方式 做 演示 。 

XML 解析 : 可 以 用 两 种 方式 解析 XML， 分 别 是 DOM 方式 和 SAX 方式 。 

异步 消息 处 理 : 通过 Handler 实现 异步 消息 处 理 ， 以 一 个 自 定义 的 异步 下 载 类 来 说 明 
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Handler 的 用 法 。 


13.2.1 实现 HTTP 通信 和 XML 解析 的 演示 


(1) 首先 定义 一 个 名 为 MySAXHandler 的 类 ， 此 类 继承 于 DefaultHandler， 功 能 是 实现 指 
定 XML 的 SAX 解析 器 。 并 且 在 下 面 的 代码 中 使 用 了 SAX 流 式 解析 方式 , 通过 事件 模型 解 


Hr XML， 这 种 方式 只 能 顺序 解析 。 


packagecom.webabcd.communication; 

importorg.xml.sax.Attributes; 

importorg.xml.sax.SAXException; 
importorg.xml.sax.helpers.DefaultHandler; 

/采用 DOM-W3C 标准 ， 需 要 把 XML 数据 全 部 加 载 完成 后 才能 对 
publicclassMySAXHandlerextendsDefaultHandler{ 
privatebooleanmlsTitleTag=false; 


IT 


做 解析 ， 可 对 树 做 任意 遍历 


privatebooleanmlsSalaryTag=false; 
privatebooleanmlsBirthTag=false; 
privateStringmResult=""; 

/打开 XML 文档 的 回调 函数 

@Override 
publicvoidstartDocument()throwsSA XException { 
//TODOAuto-generatedmethodstub 
super.startDocument(); 


j 


/关闭 XML 文档 的 回调 函数 

@Override 
publicvoidendDocument()throwsSA XException { 
//TODOAuto-generatedmethodstub 
super.endDocument(); 

} 

/一 发 现 元 素 开 始 标记 就 回调 此 函数 
@Override 
publicvoidstartElement(Stringuri,StringlocalName,StringqName, 
Attributesattributes)throwsSA XException { 
if(localName- -"title") 

mlsTitleTag=true; 


elseif(localName=="salary") 

mlsSalaryTag=true; 
elseif(localName=="dateOfBirth") 
mlsBirthTag=true; 
elseif(localName=="employee") 
mResult+="\nname:"+attributes.getValue("name"); 
j 

/一 发 现 元 素 结束 标记 就 回调 此 函数 
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publicvoidendElement(Stringuri,StringlocalName, StringqName) 


throwsSA XException { 
if(localName=="title") 
mlsTitleTag-false; 


elseif(localName=="salary") 


mlsSalaryTag-false; 
elseif(localName=="dat 
mlsBirthTag-false; 

j 


eOfBirth") 


/一 发 现 元 素 值 或 属性 值 就 回调 此 函数 


@Override 


publicvoidcharacters(char[]ch, intstart,intlength) 


throwsSA XException { 
if(mIsTitleTag) 


mResult+=newString(ch,start,length); 


elseif(mIsSalaryTag) 


mResult+="salary:"+newString(ch,start,length); 


elseif(mIsBirthTag) 


mResult+="dateOfBirth:"+newString(ch,start,length); 


j 


publicStringgetResult() { 
returnmResult; 

} 

} 


(2) 在 下 面 的 演示 代码 中 主要 定义 了 如 下 两 个 核心 方法 


o 


O 方法 httpGetDemo0: 以 HTTP 协议 的 get0 方 法 获取 远程 页 面 响应 的 内 容 。 


O 方法 httpPostDemo(): DL HTTP 协议 的 post0 方 法 向 远 得 


的 内 容 。 


packagecom.webabcd.communication; 


importjava.1o.BufferedInputStream; 


importjava.io. BufferedR 


eader; 


importjava.io. IOException; 


importjava.io.InputStream; 


importjava.io.InputStreamReader; 


importjava.net.HttpURL 
importjava.net.URL; 


Connection; 


importjava.net. URLConnection; 


importjava.util. ArrayList; 


importjava.util. HashMap; 


importjava.util.Map; 


页 面 传递 参数 ，j 


3 


取 其 响应 
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importjavax.xml.parsers. DocumentBuilder; 
importjavax.xml.parsers. DocumentBuilderFactory; 
importjavax.xml.parsers.SA X Parser; 
importjavax.xml.parsers.SA XParserFactory; 
importorg.apache.http.HttpEntity; 
importorg.apache.http.HttpResponse; 
importorg.apache.http.client.entity. UrlEncodedFormEntity; 
importorg.apache.http.client.methods.HttpPost; 
importorg.apache.http.impl.client.DefaultHttpClient; 
importorg.apache.http.message.BasicName ValuePair; 
importorg.apache.http.protocol. HTTP; 
importorg.apache.http.util. ByteArrayBuffer; 
importorg.apache.http.util. Encoding Utils; 
importorg.w3c.dom.Document; 
importorg.w3c.dom.Element; 
importorg.w3c.dom.NodeList; 
importorg.xml.sax.InputSource; 
importorg.xml.sax.XML Reader; 

importandroid.app.A ctivity; 

importandroid.os.Bundle; 

importandroid.view.View; 
importandroid.widget.Button; 
importandroid.widget.TextView; 
publicclassMainextendsActivity { 
privateTextViewtext View; 

@Override 

publicvoidonCreate(BundlesavedInstanceS tate) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
textView-(TextView)this.findViewById(R.1d.textView); 
Buttonbtn1=(Button)this.find ViewByld(R.id.btn1); 
btn1.setText("httpgetdemo"); 
btn1.setOnClickListener(newButton.OnClickListener() ( 
publicvoidonClick(Viewv) { 

httpGetDemo(); 

} 

D 

Buttonbtn2=(Button)this.find ViewByld(R.id.btn2); 
btn2.setText("httppostdemo"); 
btn2.setOnClickListener(newButton.OnClickListener() { 
publicvoidonClick(Viewv) { 

httpPostDemo(); 

} 

D 

Buttonbtn3=(Button)this.find ViewByld(R.id.btn3); 
btn3.setText("DOM 解析 XML"); 
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btn3.setOnClickListener(newButton.OnClickListener() { 
publicvoidonClick(Viewv) { 

DOMDemo(); 

} 

Ob 

Buttonbtn4=(Button)this.find ViewByld(R.id.btn4); 
btn4.setText("SAX 解析 XML"); 
btn4.setOnClickListener(newButton.OnClickListener() ( 
publicvoidonClick(Viewv) { 

SAXDemo(); 

} 

D 

} 

//Android 调用 HTTP 协议 的 get0 方 法 

/本 例 : 以 HTTP 协议 的 get0 方 法 获取 远程 页 面 响应 的 内 容 
privatevoidhttpGetDemo() { 

try{ 

/模拟 器 测试 时 ， 请 使 用 外 网 地 址 
URLurl-newURL("http://xxx.xxx.xxx"); 
URLConnectioncon-url.openConnection(); 
Stringresult="httpstatuscode:"+((HttpURLConnection)con).getResponseCode()+"\n"; 
InputStreamis=con.getInputStream(); 


BufferedInputStreambis=newBufferedInputStream(is); 
ByteArrayBufferbab=newByteArrayBuffer(32); 
intcurrent=0; 

while((current=bis.read())!=-1) ( 
bab.append((byte)current); 

} 
result+=EncodingUtils.getString(bab.toByteArray(), HTTP.UTF 8); 
bis.close(); 

is.close(); 

text View.setText(result); 

}catch(Exceptione) { 

text View.setText(e.toString()); 

j 

j 

//Android 调用 HTTP 协议 的 post0 方 法 

/本 例 : 以 HTTP. 协议 的 post0 方 法 向 远程 页 面 传递 参数 ， 并 获取 其 响应 的 内 容 
privatevoidhttpPostDemo(){ 

try{ 

/模拟 器 测试 时 ， 请 使 用 外 网 地 址 
Stringurl="http://Sbillion.com.cn/post.php"; 
Map<String,String>data=newHashMap<String, String>(); 


data.put("name",""webabcd"); 
data.put("salary","100"); 
DefaultHttpClienthttpClient-newDefaultHttpClient(); 
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HttpPosthttpPost=newHttpPost(url); 

ArrayList<BasicName ValuePair>postData=new Array List<BasicNameValuePair>(); 
for(Map.Entry<String,String>m:data.entrySet()) { 
postData.add(newBasicNameValuePair(m.getK ey(),m.getV alue())); 

} 

UrlEncodedFormEntityentity=newUrlEncodedFormEntity(postData,HTTP.UTF_8); 
httpPost.setEntity(entity); 

HttpResponseresponse-httpClient.execute(httpPost); 
Stringresult="httpstatuscode:"+response.getStatusLine().getStatusCode()+"\n"; 
HttpEntityhttpEntity=response.getEntity(); 

InputStreamis=httpEntity.getContent(); 

result+=convertStreamToString(is); 

text View.setText(result); 

}catch(Exceptione) { 

text View.setText(e.toString()); 

} 

} 

/以 DOM 方式 解析 XML 

privatevoidDOMDemo(){ 

try { 

DocumentBuilderFactorydocFactory=DocumentBuilderFactory.newInstance(); 
DocumentBuilderdocBuilder-docFactory.newDocumentBuilder(); 
Documentdoc-docBuilder.parse(this.getResources().openRawResource(R.raw.employee)); 
ElementrootElement-doc.getDocumentElement(); 
NodeListemployeeNodeList-rootElement.getElementsBy TagName("employee"); 
textView.setText("DOMDemo"-"n"); 
Stringtitle=rootElement.getElementsByTagName("title").item(0).getFirstChild().getNode Value(); 
textView.append(title); 

for(inti=0;i<employeeNodeList.getLength();i++) ( 
ElementemployeeElement=((Element)employeeNodeList.item(1)); 
Stringname=employeeElement.getAttribute("name"); 
Stringsalary-employeeElement.getElementsBy TagName("salary").item(0).getFirstChild().getNode Value); 
StringdateOfBirth-employeeElement.getElementsBy TagName("dateOfBirth").item(0).getFirstChild().ge 


tNodeValue(); 
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text View.append("\nname:"+name+"salary:"+salary+"dateOfBirth:"+dateOfBirth); 
} 

}catch(Exceptione) { 

textView.setText(e.toString()); 

j 

j 

/以 SAX 方式 解析 XML 

privatevoidSA XDemo() { 

try{ 

SAXParserFactorysaxFactory=SA XParserFactory.newInstance(); 
SA XParserparser-saxFactory.newS A XParser(); 
XMLReaderreader-parser.getX MLReader(); 
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MySA XHandlerhandler=newMySA XHandler(); 
reader.setContentHandler(handler); 


reader.parse(newInputSource(this.getResources().openRawResource(R.raw.employee))); 


Stringresult=handler. getResult(); 

text View.setText("SAXDemo"+"\n"); 

text View.append(result); 

}catch(Exceptione) { 

text View.setText(e.toString()); 

} 

} 

/辅助 方法 ， 用 于 把 流转 换 为 字符 串 
privateStringconvertStreamToString(InputStreamis) { 


BufferedReaderreader=newBufferedReader(newInputStreamReader(is)); 


StringBuildersb=newStringBuilder(); 
Stringline=null; 

try{ 
while((line=reader.readLine())!=null) { 
sb.append(line+"\n"); 

} 

}catch(IOExceptione) { 
e.printStackTrace(); 

} finally { 

try { 

is.close(); 

}catch(IOExceptione) { 
e.printStackTrace(); 

} 

} 

returnsb.toString(); 

} 

} 


13.2.2 ”使 用 Handler 实现 异步 消息 处 理 


在 接 下 来 的 演示 代码 中 ， 以 一 个 可 以 实时 汇报 下 载 进度 的 异步 
Android 类 库 。 在 以 下 演示 代码 中 此 类 库 的 名 字 为 webabcd util. IA 


User Libraries 一 New， 这 样 可 为 类 库 起 一 个 名 字 


然后 选中 这 


载 类 为 例 ， 开 发 了 一 个 


TZ, 单 击 


Android 的 jar 包 。 最 后 在 项 目 上 
选择 Android FÉ. 


packagewebabcd.util; 
importjava.io. BufferedReader; 
importjava.io.File; 


importjava.io.FileOutputStream; 


F Eclipse， 依 次 单 击 New 
一 Java Project， 然 后 在 项 目 上 单 击 右键 并 依次 选择 Build Pati Aad Libraries User Library > 


Add JARs 导入 
单 击 右键 ， nmm 先 择 Build Path— Add Libraries User Library 
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importjava.io.InputStream; 
importjava.io.InputStreamReader; 
importjava.net.URL; 

importjava.net. URLConnection; 
importorg.apache.http.protocol.HTTP; 
importandroid.os.Handler; 
importandroid.os.Message; 
importandroid.util.Log; 


// 以 一 个 异步 下 载 实例 ， 来 演示 Android 的 异步 消息 处 理 〈 用 


publicclassDownloadManagerAsync{ 
publicDownloadManagerAsync(){ 

} 

// 实 例 化 自 定义 的 Handler 
EventHandlermHandler=newEventHandler(this); 

// 按 指定 url 地 址 下 载 文件 到 指定 路 径 
publicvoiddownload(finalStringurl,finalStringsavePath) ( 


newThread(newRunnable() { 

publicvoidrun()( 

try{ 

sendMessage(FILE DOWNLOAD CONNECT); 
URLsourceUrl-newURL (url); 
URLConnectionconn-sourceUrl.openConnection(); 
InputStreaminputStream-conn.getInputStream(); 
intfileSize-conn.getContentLength(); 
Filesavefile=newFile(savePath); 

if(savefile.exists()) { 

savefile.delete(); 

} 

savefile.createNewFile(); 
FileOutputStreamoutputStream-newFileOutputStream( 
savePath,true); 

byte[]buffer-newbyte[ 1024]; 

intreadCount=0; 

intreadNum=0; 

intprevPercent=0; 

while(readCount<fileSize& &readNum!=-1) { 
readNum=inputStream.read( buffer); 

if(readNum>-1){ 

outputStream. write(buffer); 
readCount=readCount+readNum; 
intpercent-(int)(readCount*100/fileSize); 
if(percent>prevPercent) ( 

/发 送 下 载 进度 信息 
sendMessage(FILE DOWNLOAD UPDATE,percent, 
readCount); 


Handler 的 方式 ) 
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prevPercent-percent; 
j 
j 
j 


outputStream.close(); 
sendMessage(FILE DOWNLOAD COMPLETE,savePath); 
}catch(Exceptione) ( 

sendMessage(FILE DOWNLOAD ERROR,e); 
Log.e("MyError",e.toString()); 

} 

} 

}). start); 

} 

// 读 取 指 定 URL 地 址 的 响应 内 容 
publicvoiddownload(finalStringurl) { 

newThread(newRunnable() { 

publicvoidrun() { 

try{ 

sendMessage(FILE DOWNLOAD CONNECT); 
URLsourceUrl=newURL(url); 
URLConnectionconn=sourceUrl.openConnection(); 
conn.setConnectTimeout(3000); 
BufferedReaderreader=newBufferedReader( 
newInputStreamReader(conn.getInputStream(), 

HTTP.UTF 8)); 

Stringline-null; 

StringBuffercontent=newStringBuffer(); 
while((line=reader.readLine())!=null) { 

content.append(line); 

} 

reader.close(); 
sendMessage(FILE DOWNLOAD COMPLETE,content.toString()); 
}catch(Exceptione) ( 

sendMessage(FILE DOWNLOAD ERROR,e); 
Log.e("MyError",e.toString()); 

} 

} 

}).startQ); 

} 

/向 Handler 发 送 消息 
privatevoidsendMessage(intwhat,Objectobj) { 
// 构 造 需 要 癌 Handler 发 送 的 消息 
Messagemsg=mHandler.obtainMessage(what, obj); 
/发 送 消息 
mHandler.sendMessage(msg); 
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} 

privatevoidsendMessage(intwhat) { 
Messagemsg=mHandler.obtainMessage(what); 
mHandler.sendMessage(msg); 

} 

privatevoidsendMessage(intwhat,intarg 1 ,intarg2) { 
Messagemsg=mHandler.obtainMessage(what,arg 1,arg2); 
mHandler.sendMessage(msg); 

j 

privatestaticfinalintFILE DOWNLOAD CONNECT-0; 
privatestaticfinalintFILE DOWNLOAD UPDATE-I; 
privatestaticfinalintFILE DOWNLOAD COMPLETE-2; 
privatestaticfinalintFILE DOWNLOAD ERROR--1; 

/ 自 定义 的 Handler 
privateclassEventHandlerextendsHandler { 
privateDownloadManagerAsyncmManager; 
publicEventHandler(DownloadManagerAsyncmanager) { 
mManager=manager; 

j 

/处 理 接收 到 的 消息 
@Override 
publicvoidhandleMessage(Messagemsg) { 


switch(msg. what) { 

caseFILE DOWNLOAD_CONNECT: 
if(mOnDownloadConnectListener!=null) 
mOnDownloadConnectListener.onDownloadConnect(mManager); 
break; 

caseFILE DOWNLOAD UPDATE: 
if(mOnDownloadUpdateListener!=null) 
mOnDownloadUpdateListener.onDownloadUpdate(mManager, 
msg.argl); 

break; 

caseFILE DOWNLOAD COMPLETE: 
ifímOnDownloadCompleteListener! =null) 
mOnDownloadCompleteListener.onDownloadComplete(mManager, 
msg.obj); 

break; 

caseFILE DOWNLOAD ERROR: 
if(mOnDownloadErrorListener!=null) 
mOnDownloadErrorListener.onDownloadError(mManager, 
(Exception)msg.obj); 

break; 

default: 

break; 


j 
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} 
j 
/定义 连接 事件 


privateOnDownloadConnectListenermOnDownloadConnectListener; 


publicinterfaceOnDownloadConnectListener{ 
voidonDownloadConnect(DownloadManagerAsyncmanager); 

} 
publicvoidsetOnDownloadConnectListener(OnDownloadConnectListenerlistener) { 
mOnDownloadConnectListener=listener; 

} 

/定义 下 载 进度 更 新 事件 
privateOnDownloadUpdateListenermOnDownloadUpdateListener; 
publicinterfaceOnDownloadUpdateListener { 
voidonDownloadUpdate(DownloadManagerAsyncmanager,intpercent); 


} 
publicvoidsetOnDownloadUpdateListener(OnDownloadUpdateListenerlistener) { 


mOnDownloadUpdateListener=listener; 
} 
/定义 下 载 完成 事件 


privateOnDownloadCompleteListenermOnDownloadCompleteListener; 


publicinterfaceOnDownloadCompleteListener { 
voidonDownloadComplete(DownloadManagerAsyncmanager,Objectresult); 
} 

publicvoidsetOnDownloadCompleteListener( 
OnDownloadCompleteListenerlistener) { 
mOnDownloadCompleteListener=listener; 

} 

He SUP BH it SHE 


privateOnDownloadErrorListenermOnDownloadErrorListener; 


pun 


publicinterfaceOnDownloadErrorListener { 
voidonDownloadError(DownloadManagerAsyncmanager,Exceptione); 


j 


publicvoidsetOnDownloadErrorListener(OnDownloadErrorListenerlistener) { 


mOnDownloadErrorListener-listener; 


j 
j 


然后 调用 上 面 自 定义 的 Android 类 库 , 在 项 目 上 
Build Path 一 Projects 一 Add 命令 来 引用 上 面 的 类 库 。 


Pai 


,然后 依次 选择 Properties Java 


packagecom.webabcd.handler; 
importandroid.app.A ctivity; 
importandroid.os.Bundle; 
importandroid.widget. Text View; 
importwebabcd.util.DownloadManagerAsync; 
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在 现实 应 用 中 ， 直 接 使 用 单线 程 下 载 HTTP. 文件 是 一 件 非常 简单 的 
使 用 多 线程 断 点 下 载 。 在 本 节 将 通过 一 个 具体 实例 的 实现 过 程 ， 详 细 讲解 在 Android 系统 


publicclassMainextendsActivityimplements 
DownloadManagerAsync.OnDownloadCompleteListener, 
DownloadManagerAsync.OnDownloadUpdateListener, 
DownloadManagerAsync.OnDownloadErrorListener { 

TextViewtxt; 

/**Calledwhentheactivityisfirstcreated.*/ 

@Override 

publicvoidonCreate(BundlesavedInstanceState) { 
super.onCreate(savedInstanceState); 

setContentView(R.layout.main); 
DownloadManagerAsyncmanager=newDownloadManagerAsync(); 
manager.setOnDownloadCompleteListener(this); 
manager.setOnDownloadUpdateListener(this); 
manager.download("http://files.cnblogs.com/webabed/Android.rar","/sdcard/Android.rar"); 
txt=(Text View)this.findViewByld(R.id.txt); 

txt.setText(" 开 始 下 载 "); 

} 
publicvoidonDownloadComplete(DownloadManagerAsyncmanager,Objectresult) { 
txt.setText(" 下 载 完成 "); 

} 
publicvoidonDownloadUpdate(DownloadManagerAsyncmanager,intpercent) ( 
txt.setText(" 下载 进度 : "+String.valueOf(percent)+"%"); 

} 

publicvoidonDownloadError(DownloadManagerAsyncmanager, Exceptione) { 
txt.setText(" FS fi"); 

} 

} 


实现 网 络 多 线程 断 点 下 载 


Und 


D 


Po 


实现 网 络 多 线程 断 点 下 载 的 方法 。 


13.3.1 


实现 原理 


要 想 从 文件 的 指定 位 置 处 开始 文件 下 载 ， 可 以 通过 HTTP 请 求 信息 头 来 设置 ， 


有。 其 实 还 可 以 尝试 


L 


Ei 


HTTP 请 求 信息 头 的 “Range” 属 性 。 在 解决 了 多 线程 下 载 问题 后 ， 接 下 来 开始 解决 文 持 断 点 
下 载 问 题 。 整 个 过 程 非常 简单 ， 只 需 将 下 载 的 进度 保存 到 文件 中 即 可 ， 但 是 在 Android PAN 
不 能 这 么 做 。 在 Android 平台 中 ， 需 要 向 文件 
写 入 下 载 进度 ， 在 这 个 过 程 中 通常 


以 文件 的 方式 来 保存 下 载 进度 ， 但 可 以 通过 数据 库 的 方式 来 保存 下 载 进度 。 
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gt 


Su 


写 入 下 载 的 文件 数据 ， 还 需要 向 另 一 个 文 
会 导致 某 个 文件 的 内 容 没 有 被 写 入 错误 。 所 以 我 们 就 不 能 


hb 
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13.3.2 具体 实现 


(1) 创建 Android 工程 ， 整 个 工程 的 相关 参数 如 下 。 
L] Project name: MulThreadDownloader. 

LI BuildTarget: Android 4.4. 

C] Application name: 多 线程 断 点 下 载 。 

QO) Package name: com.changcheng.download. 

L] Create Activity: MulThreadDownloader. 

(2) 编写 文件 AndroidManifestxml， 在 此 文件 中 主要 设置 如 下 三 个 权限 。 
口 在 SDCard 中 创建 与 删除 文件 权 。 

Q 在 SDCard 文件 中 选取 内 容 。 

口 在 SDCard 文件 中 写 入 数据 。 

具体 代码 如 下 。 


<?xmlversion="1.0"encoding="utf-8"?> 
<manifestxmlns:android="http://schemas.android.com/apk/res/android" 
package-"com.changcheng.download" 

android:versionCode-" 1" 

android:versionName-" 1.0" 
<applicationandroid:icon="@drawable/icon"android:label="@string/app_name"> 
<activityandroid:name=".MulThreadDownloader" 
android:label="@string/app_name"> 

<intent-filter> 

<actionandroid:name="android.intent.action. MAIN"/> 
<categoryandroid:name="android.intent.category. LAUNCHER"/> 
</intent-filter> 

</activity> 

</application> 

<uses-sdkandroid:minSdkVersion="20"/> 

<!-- 在 SDCard 中 创建 与 删除 文件 权限 --> 
<uses-permissionandroid:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> 
<!-- 往 SDCard 写 入 数据 权限 --> 
<uses-permissionandroid:name="android.permission.WRITE EXTERNAL STORAGE"/> 
<!-- Jj i] internet 权限 --> 
«uses-permissionandroid:name-"android.permission.INTERNET"/- 


</manifest> 


(3) 编写 文件 strings.xml， 有 具体 代码 如 下 。 


<?xmlversion="1.0"encoding="utf-8"?> 

<resources> 
<stringname="hello">HelloWorld,DownloadActivity!</string> 
<stringname="app_name"> 多 线程 断 点 下 载 </string> 
<stringname="path"> 下载 路 径 </string> 
<stringname="downloadbutton"> 下载 </string> 
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(4) 


(5) 
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<stringname="sdcarderror">SDCard 不 存在 或 者 写 保 护 </ string> 


</resources> 


编写 UI 布局 文件 main.xml， 具 体 代码 如 下 。 


<?xmlversion="1.0"encoding="utf-8"?> 
«LinearLayoutxmlIns:android-"http://schemas.android.com/apk/res/android" 


android:orientation-" vertical" 
android:layout width-"fill parent" 


android:layout height-"fill parent" 


> 
<1- FREE > 
<TextView 


android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/path" 

[^ 

«EditText 

android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="http://www.winrar.com.cn/download/wrar380sc.exe" 
android:id="@+id/path" 

ZC 

<!-- 下 载 按钮 -> 

<Button 


android:layout_width 


wrap content" 
android:layout height-"wrap content" 
android:text="@string/downloadbutton" 
android:id="(@+id/button" 

> 


<!-- 进 度 条 --> 


<ProgressBar 


android:layout_width="fill_parent" 
android:layout_height="20dip" 
style="?android:attr/progressBarStyleHorizontal" 
android:id="(@+1id/downloadbar"/> 

<1-- 进 度 %--> 

<TextView 


android:layout_width="fill_parent" 


—" 


android:layout height-"wrap content" 
android:gravity-" center" 
android:id="@-+id/resultView" 

Je 


</LinearLayout> 


编写 文件 MulThreadDownloaderjava, Jf P. 
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packagecom.changcheng.download; 
importjava.io.File; 
importcom.changcheng.net.download.DownloadProgressListener; 
importcom.changcheng.net.download.FileDownloader; 
importcom.changcheng.download.R; 
importandroid.app.A ctivity; 
importandroid.os.Bundle; 
importandroid.os.Environment; 
importandroid.os.Handler; 
importandroid.os.Message; 
importandroid.view.View; 
importandroid.widget.Button; 
importandroid.widget.EditText; 
importandroid.widget. ProgressBar; 
importandroid.widget.Text View; 
importandroid.widget.Toast; 
publicclassMulThreadDownloaderextendsA ctivity { 
privateEditTextpathText; 
privateProgressBarprogressBar; 
privateTextViewresultView; 
privateHandlerhandler=new Handler() ( 

@Override 
publicvoidhandleMessage(Messagemsg) { 
if(!Thread.currentThread().isInterrupted()) { 
switch(msg. what) { 

casel: 

/获取 当前 文件 下 载 的 进度 
intsize-msg.getData().getInt("size"); 


progressBar.setProgress(size); 
intresult-(int)(((float)size/(float)progressBar.getMax())*100); 

result View.setText(result+"%"); 

if(progressBar.getMax()==size) { 
Toast.makeText(MulThreadDownloader.this," XF FRSE", 1).show(); 
} 

break; 


case-1: 


Stringerror=msg.getData().getString("error"); 
Toast.makeText(MulThreadDownloader.this,error, 1 ).show(); 
break; 

} 

} 

super. handleMessage(msg); 

} 

jg 

@Override 

publicvoidonCreate(BundlesavedInstanceState) { 
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super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 


pathText-(EditText)this.findViewById(R.id.path); 


progressBar-(ProgressBar)this.find ViewById(R.id.downloadbar); 
result View-(TextView)this.findViewById(R.id.resultView); 


Buttonbutton-(Button)this.find ViewByld(R.id.button); 
button.setOnClickListener(newView.OnClickListener() { 


@Override 
publicvoidonClick(Viewv) { 
Stringpath=pathText.getText().toString(); 


if(Environment.getExternalStorageS tate().equals(Environment. MEDIA MOUNTED))( 
/下 载 文件 需要 很 长 的 时 间 ， 主 线程 是 不 能 够 长 时 间 被 阻塞 ， 如 果 主 线程 被 长 时 间 阻 塞 ， 那 么 


/Android 被 回收 应 用 


download(path,Environment.getExternalStorageDirectory()); 


yelse { 


Toast.makeText(MulThreadDownloader.this,R.string.sdcarderror,1).show(); 


[** 
* 下 载 文件 
*@parampath 下 载 路 径 
*@paramsaveDir 文件 保存 目录 
ei 


/对 于 Android 的 UI 控件 ， 只 能 由 主线 程 负责 显示 界 


T 


// 显 不 


publicvoiddownload(finalStringpath,finalFilesaveDir){ 


newThread(newRunnable() { 
@Override 
publicvoidrun() { 


看 的 更 新 ， 其 他 线程 不 能 直接 更 新 UI 控件 的 


FileDownloaderdowner=newFileDownloader(MulThreadDownloader.this,path,saveDir,3); 
progressBar.setMax(downer.getFileSize());// 设 置 进度 条 的 最 大 刻度 


try{ 


downer.download(newDownloadProgressListener() { 


@Override 
publicvoidonDownloadSize(intsize) ( 
Messagemsg=newMessage(); 
msg.what=1; 
msg.getData().putInt("size",size); 
handler.sendMessage(msg);// 4:395 114 E 
i» 

\catch(Exceptione) { 


Messagemsg=newMessage(); 
msg.what=-1; 
msg.getData().putString("error"," Fak AM"); 
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handler.sendMessage(msg); 
j 

j 

}).startQ); 

} 

j 


编写 文件 FileDownload.java， 上 有 具体 代码 如 下 。 


packagecom.changcheng.net.download; 
importjava.io.File; 
importjava.io.RandomAccessFile; 
importjava.net.HttpURLConnection; 
importjava.net.URL; 
importjava.util.LinkedHashMap; 
importjava.util.Map; 
importjava.util. UUID; 
importjava.util.concurrent. ConcurrentHashMap; 
importjava.util.regex.Matcher; 
importjava.util.regex.Pattern; 
importcom.changcheng.download.service.FileService; 
importandroid.content.Context; 
importandroid.util.Log; 

/* * 

* SCPE PUn 

St 

publicclassFileDownloader { 
privateContextcontext; 
privateFileServicefileService; 
privatestaticfinalStringT AG="FileDownloader"; 
fup At 
privateintdownloadSize-0; 

此 原始 文件 大 小 */ 
privateintfileSize=0; 

BIER] 
privateDownloadThread[]threads; 

P PAURTEN 

privateURLurl; 

此 本 地 保存 文件 */ 
privateFilesaveFile; 

Ih riesen 
privateFilelogFile; 

证 缓存 各 线程 最 后 下 载 的 位 置 */ 


privateMap<Integer, Integer>data=newConcurrentHashMap<Integer, Integer>(); 


人 # 每 条 线程 下 载 的 大 小 并 
privateintblock; 
privateStringdownloadUrl;// F Zt f 
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/* * 
* 获 取 线程 数 
E 
publicintgetThreadSize() { 
returnthreads. length; 
j 
/* * 
* 获 取 文 件 大 小 
*@return 
St 
publicintgetFileSize() { 


returnfileSize; 

j 

/* * 

* 累 计 已 下 载 大 小 

*@paramsize 

E 
protectedsynchronizedvoidappend(intsize) { 
downloadSize+=size; 


j 


* 更 新 指定 线程 最 后 下 载 的 位 置 
*@paramthreadId 线程 id 
*@parampos 最 后 下 载 的 位 置 
i 
protectedvoidupdate(intthreadId,intpos) ( 
this.data.put(threadId,pos); 

} 

/* * 

* 保 存 记录 文件 

Si 

protectedsynchronizedvoidsaveLogFile() { 

this. fileService.update(this.downloadUrl,this.data); 


} 

[** 

* 构 建文 件 下 载 器 
*@paramdownloadUrl 下 载 路 径 
*@paramfileSaveDir 文件 保存 目录 
*@paramthreadNum 下 载 线程 数 
publicFileDownloader(Contextcontext,StringdownloadUrl,FilefileSaveDir,intthreadNum) { 
try { 

this.context=context; 
this.downloadUrl=downloadUrl; 
fileService=newFileService(context); 
this.url=newURL(downloadUrl); 
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if(!fileSaveDir.exists())fileSaveDir.mkdirs(); 

this.threads-newDownloadThread[threadNum]; 

Http URLConnectionconn=(HttpURLConnection)url.openConnection(); 

conn.setConnectTimeout(6*1000); 

conn.setRequestMethod("GET"); 

conn.setRequestProperty("Accept","image/gif,image/jpeg,image/pjpeg,image/pjpeg,application/x-shockw 
ave-flash,application/xaml+xml,application/vnd.ms-xpsdocument,application/x-ms-xbap,application/x-ms-applicatio 
n,application/vnd.ms-excel,application/vnd.ms-powerpoint,application/msword,*/*"); 

conn.setRequestProperty("Accept-Language","zh-CN"); 

conn.setRequestProperty("Referer",downloadUrl); 

conn.setRequestProperty("Charset","UTF-8"); 

conn.setRequestProperty("User-Agent","Mozilla/4.0(compatible; MSIE8.0; WindowsNT5S.2;Trident/4.0;. 
NETCLRI1.1.4322;.NETCLR2.0.50727;.NETCLR3.0.04506.30;.NETCLR3.0.4506.2152;.NETCLR3.5.30729)"); 

conn.setRequestProperty("Connection","Keep-Alive"); 

conn.connect(); 

printResponseHeader(conn); 

if(conn.getResponseCode()==200) { 

this.fileSize=conn.getContentLength();// 根 据 响应 获取 文件 大 小 

iftthis.fileSize<=0)thrownewRuntimeException(" 无 法 获知 文件 大 小 "); 

Stringfilename-getFileName(conn); 

this.saveFile-newFile(fileSaveDir,filename);/* fff 3c ai 

Map <Integer, Integer>logdata=fileService.getData(downloadUrl); 

if(logdata.size()>0) { 

data.putAll(logdata); 

} 

this.block=this.fileSize/this.threads.length+1; 

if(this.data.size()- —this.threads.length) { 

for(inti=0;i<this.threads.length;i++) { 

this.downloadSize+=this.data.get(i+1)-(this.block*1); 

} 

print(" 已 经 下 载 的 长 度 "+this.downloadSize); 

} 

yelse { 

thrownewRuntimeException(" 服 务 器 响应 错误 "); 

} 

}catch(Exceptione){ 

print(e.toString()); 

thrownewRuntimeException(" 连 接 不 到 下 载 路 径 "); 

} 

} 

/* * 

* 获 取 文 件 名 

E 

privateStringgetFileName(HttpURL Connectionconn) ( 

Stringfilename=this.url.toString().substring(this.url.toString().lastIndexOf(‘/')+1); 

if(filename= nulll"".equals(filename.trim0)){// 如 果 获 取 不 到 文件 名 称 
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for(inti=0;;i++) { 

Stringmine=conn.getHeaderField(i); 

if(mine- -null)break; 
if("content-disposition".equals(conn.getHeaderFieldKey(i).toLowerCase())) ( 
Matcherm=Pattern.compile(".*filename=(.*)").matcher(mine.toLowerCase()); 
if(m.find())returnm.group(1); 

} 

} 

filename=UUID.randomUUIDO+".tmp";// 默 认 取 一 个 文件 名 

} 

returnfilename; 

} 

/* x 

* 开 始 下 载 文件 

*@paramlistener 监听 下 载 数量 的 变化 ,如 果 不 需 要 了 解 实时 下 载 的 数量 ,可 以 设置 为 null 
*(greturn 已 下 载 文件 大 小 

*@throwsException 

ei 

publicintdownload(DownloadProgressListenerlistener)throwsException ( 

try { 

if(this. data.size()!=this.threads.length) { 

this.data.clear(); 

for(inti=0;i<this.threads.length;i++) { 

this.data.put(i+1 ,this.block*i); 

} 

} 

for(inti=0;i<this.threads.length;i++) { 

intdownLength=this.data.get(i+1 )-(this.block*1); 

这 downLength<this.block&&cthis.data.get(i+l)<this.fileSize){W 该 线程 未 完成 下 载 时 ,继续 下 载 
RandomAccessFilerandOut=newRandomAccessFile(this.saveFile,"rw"); 
if(this.fileSize>0)randOut.setLength(this.fileSize); 

randOut.seek(this.data. get(i+1)); 
this.threads[i]=newDownloadThread(this,this.url,randOut,this.block,this.data.get(it+1),i+1); 
this.threads[1].setPriority(7); 

this.threads[1].start(); 

}else{ 

this.threads[1]=null; 

} 

} 


this. fileService.save(this.downloadUrl,this.data); 
booleannotFinish=true;/ 下 载 未 完成 
while(notFinish){// 循 环 判 断 是 否 下 载 完 毕 
Thread.sleep(900); 

notFinish=false:;// 假 定 下 载 完成 
for(inti=0;i<this.threads.length;i++) { 
if(this.threads[i]!=null& &!this.threads[i].isFinish()) { 
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notFinish=true;// 下 载 没 有 完成 
if(this.threads[i].getDownLength()==-1){// 如 果 下 载 失 败 ,再 重新 下 载 
RandomAccessFilerandOut=newRandomAccessFile(this.saveFile,"rw"); 
randOut.seek(this.data. get(i+1)); 
this.threads[i]-newDownloadThread(this,this.url,randOut,this.block,this.data.get(1--1),1-1); 
this.threads[1].setPriority(7); 

this.threads[1].start(); 

j 

j 

j 

if(listener!=null)listener.onDownloadSize(this.downloadSize); 

} 

fileService.delete(this.downloadUrl); 

}catch(Exceptione) { 


print(e.toString()); 

thrownewException(" F 2x We"); 

j 

returnthis.downloadSize; 

} 

A LES 

* 获 取 Http 响应 头 字 段 

*@paramhttp 

*@return 

zy 
publicstaticMap<String,String>getHttpResponseHeader(Http URLConnectionhttp) { 
Map<String,String>header=newLinkedHashMap<String, String>(); 
for(inti=0;;1++) { 

Stringmine-http.getHeaderField(i); 

if(mine- -null)break; 

header.put(http.getHeaderFieldK ey(1),mine); 

j 

returnheader; 

j 

/ LES 

*4T EJ Http 头 字段 

*@paramhttp 

=i) 
publicstaticvoidprintResponseHeader(HttpURLConnectionhttp) { 
Map<String,String>header=getHttpResponseHeader(http); 
for(Map.Entry<String,String>entry:header.entrySet()) { 
Stringkey-entry.getKey()!—null?entry.getK ey()*":":""': 
print(key--entry.getValue()); 

j 

j 

privatestaticvoidprint(Stringmsg) { 

Log.i(TAG,msg); 
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(7) 


(8) 
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} 
} 


编写 文件 DownloadProgressListener.java， 具 体 代码 如 下 。 


packagecom.changcheng.net.download; 
publicinterfaceDownloadProgressListener { 
publicvoidonDownloadSize(intsize); 


j 
编写 文件 FileServicejava, Hr. 


packagecom.changcheng.download.service; 
importjava.util.HashMap; 
importjava.util.Map; 
importandroid.content.Context; 
importandroid.database.Cursor; 
importandroid.database.sqlite.SQLiteDatabase; 
/* * 

* 业 务 bean 

* 

oi 

publicclassFileService { 
privateDBOpenHelperopenHelper; 
publicFileService(Contextcontext) { 
openHelper=newDBOpenHelper(context); 


* 获 取 线 程 最 后 下 载 位 置 

*@parampath 

*@return 

E 

publicMap<Integer, Integer>getData(Stringpath) { 
SQLiteDatabasedb=openHelper.getReadableDatabase(); 
Cursorcursor=db.rawQuery("selectthreadid,positionfromfiledownwheredownpath=?" newString[] {path} ); 


Map<Integer, Integer>data=newHashMap<Integer, Integer>(); 
while(cursor.moveToNext()) { 
data.put(cursor.getInt(0),cursor.getInt(1)); 

j 

cursor.close(); 

db.close(); 

returndata; 

j 

i xk 

* 保 存 下 载 线程 初始 位 置 
*@parampath 
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*@parammap 

“= 

publicvoidsave(Stringpath, Map<Integer, Integer>map) {//intthreadid,intposition 
SQLiteDatabasedb=openHelper.getWritableDatabase(); 

db.beginTransaction(); 

try { 

for(Map.Entry<Integer,Integer>entry:map.entrySet()) { 
db.execSQL("insertintofiledown(downpath,threadid,position)values(?,?,?)", 
newObject[] {path,entry.getKey(),entry.getValue()}); 

} 

db.setTransactionSuccessful(); 

} finally { 

db.endTransaction(); 

} 

db.close(); 

} 

/* * 

* 实 时 更 新 线程 的 最 后 下 载 位 置 
*@parampath 


*@parammap 

if 

publicvoidupdate(Stringpath, Map<Integer, Integer>map) { 
SQLiteDatabasedb=openHelper.getWritableDatabase(); 
db.beginTransaction(); 

try{ 
for(Map.Entry<Integer,Integer>entry:map.entrySet()){ 
db.execSQL("updatefiledownsetposition-?wheredownpath-?andthreadid-?", 
newObject[] {entry.getValue(),path,entry.getKey()}); 

} 

db.setTransactionSuccessful(); 

} finally { 

db.endTransaction(); 

} 

db.close(); 

} 

A 米 米 

* 当 文件 下 载 完 成 后 ， 清 掉 该 文件 对 应 的 下 载 记录 
*@parampath 

e? 

publicvoiddelete(Stringpath) { 
SQLiteDatabasedb=openHelper.getWritableDatabase(); 
db.execSQL("deletefromfiledownwheredownpath=?" newObject[] {path} ); 
db.close(); 


j 
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(9) 编写 文件 DownloadThread.java， 具 体 代 码 如 下 。 


packagecom.changcheng.net.download; 
importjava.io.InputStream; 
importjava.io.RandomAccessFile; 
importjava.net.HttpURLConnection; 
importjava.net.URL; 

importandroid.util.Log; 
publicclassDownloadThreadextendsThread { 
privatestaticfinalStringT AG="DownloadThread"; 
privateRandomAccessFilesaveFile; 
privateURLdownUrl; 

privateintblock; 

PBF aA RS 

privateintthreadId—-1; 

privateintstartPos; 


privateintdownLength; 

privatebooleanfinish-false; 

privateFileDownloaderdownloader; 

publicDownloadThread(FileDownloaderdownloader, URLdownUrl,RandomAccessFilesaveFile,intblock,i 
ntstartPos,intthreadId) { 

this.downUrl-downUrl; 

this.saveFile-saveFile; 

this.block-block; 

this.startPos-startPos; 

this.downloader-downloader; 

this.threadId-threadld; 

this.downLength=startP os-(block*(threadId-1)); 

} 

@Override 

publicvoidrun() { 

if(downLength<block){// 未 下 载 完 成 

try{ 

Http URLConnectionhttp=(Http URLConnection)downUrl.openConnection(); 
http.setRequestMethod("GET"); 

http.setRequestProperty(""Accept"," image/gif, image/jpeg,image/pjpeg,image/pjpeg,application/x-shockw 
ave-flash,application/xaml+xml,application/vnd.ms-xpsdocument,application/x-ms-xbap,application/x-m s- 
application,application/vnd.ms-excel,application/vnd.ms-powerpoint,application/msword,*/*"); 
http.setRequestProperty("Accept-Language","zh-CN"); 

http.setR equestProperty(""Referer",downUrl.toString()); 
http.setRequestProperty("Charset","UTF-8"); 


http.setRequestProperty("Range","bytes="+this.startPos+"-"); 

http.setRequestProperty("User-A gent",""Mozilla/4.0(compatible; MSIE8.0;WindowsNT5.2;Trident/4.0;. 
NETCLRI.1.4322;.NETCLR2.0.50727;.NETCLR3.0.04506.30;.N ETCLR3.0.4506.2152;.NETCLR3.5.30729)"; 
http.setRequestProperty(" Connection" ,"Keep-Alive"); 


InputStreaminStream-http.getInputStream(); 
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intmax=block>1024?1024:(block>10?10:1); 

byte[]buffer=newbyte[max]; 

intoffset=0; 

print(" 线 程 "+this.threadId+" 从 位 置 "+this.startPos+" 开 始 下 载 "); 
while(downLength<block&&(offset=inStream.read(buffer,0,max))!=-1){ 
saveFile.write(buffer,0,offset); 

downLength+=offset; 
downloader.update(this.threadId,block*(threadId-1)+downLength); 
downloader.saveLogFile(); 


downloader.append(offset); 
intspare=block-downLength;/ 求 剩 下 的 字 节 数 
if(spare<max )max=(int)spare; 

j 

saveFile.close(); 

inStream.close(); 

print("£& F£"--this.threadId--" 5& V, F 4k"); 
this.finish-true; 

this.interrupt(); 

}catch(Exceptione) { 

this.downLength=- 1; 

print(" 线 程 "+this.threadId+":"+e); 

} 

} 

} 

privatestaticvoidprint(Stringmsg) { 
Log.i(TAG,msg); 

j 

/* * 

* 下 载 是 否 完成 

*@return 

ef 

publicbooleanisFinish() { 

returnfinish; 

} 

/* * 

* 已 经 下 载 的 内 容 大 小 

*@return 如 果 返 回 值 为 -1, 代 表 下 载 失 败 
ef 

publiclonggetDownLength() { 


returndownLength; 


} 
} 


(10) 编写 文件 DBOpenHelperjava， 上 有 具体 代码 如 下 。 


packagecom.changcheng.download.service; 
importandroid.content.Context; 
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importandroid.database.sqlite.SQLiteDatabase; 
importandroid.database.sqlite. SQLiteOpenHelper; 
publicclassDBOpenHelperextendsSQLiteOpenHelper{ 
privatestaticfinalStringDBNAME-"download.db"; 
privatestaticfinalintV ERSION-2; 
publicDBOpenHelper(Contextcontext) { 
super(context, DBNAME,null, VERSION); 


j 


@Override 

publicvoidonCreate(SQLiteDatabasedb) { 
db.execSQL("CREATETABLEIFNOTEXISTSfiledown(idintegerprimarykeyautoincrement,downpathva 
rchar(100),threadidINTEGER,positionINTEGER)"); 

j 

@Override 

publicvoidonUpgrade(SQLiteDatabasedb, intoldVersion,intnew Version) { 
db.execSQL("DROPTABLEIFEXISTSfiledown"); 

onCreate(db); 

j 

j 


13.4 ”判断 当前 网 络 中 GPRS 和 Wi-Fi 的 状态 


fr Android 开发 过 程 中 ， 特 别 是 在 开发 和 网 络 相 关 的 一 些 应 用 时 ， 很 可 能 会 用 到 网 络 连 
接 状 态 ， 包 括 GPRS. Wi-Fi 等 。 其 实 解决 这 些 问 BH EE fal, Android 提供 了 两 个 类 ， 


一 个 是 ConnectivityManager， 一 个 是 NetworkImfo， 通 过 这 两 个 类 即 可 判断 当前 网 络 GPRS 和 
Wi-Fi 的 状态 。 
13.41 ConnectivityManager = NetworkInio 类 

fr Android 开发 过 程 中 ， 通 过 类 enc bei 可 以 实现 管理 和 网 络 连接 相关 的 操 


作 ， 例 如 相关 的 ioi ines 可 以 管理 与 手机 、 运 营 商 等 的 相关 信息 ， 而 WifiManager 
则 管理 与 Wi-Fi 相关 的 信息 。 
要 想 访 问 网 络 状 态 ， 首 先 得 添加 如 下 权限 。 


<uses-permissionandroid:name="android.permission.ACCESS NETWORK STATE"/- 


类 NetworkInfo 包含 了 对 Wi-Fi HI Mobile 两 种 网 络 连接 模式 的 详细 描述 ,通过 其 getState() 
去 获取 的 State 对 象 则 代表 着 连接 成 功 与 否 的 状态 。 
例如 下 面 的 代码 演示 了 这 两 个 类 的 基本 用 法 。 


Pee, 


方 


publicvoidtestConnectivityManager() { 
ConnectivityManagerconnManager=(ConnectivityManager)this 
.getSystemService(CONNECTIVITY SERVICE); 


/获取 代表 联网 状态 的 NetWorkInfo 8] 
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NetworkInfonetworkInfo=connManager.getActiveNetworkInfo(); 


/获取 当前 的 网 络 连接 是 否 可 用 
booleanavailable=networkInfo.isA vailable(); 
if(available) { 

Log.i(" 通 知 "," 当 前 的 网 络 连接 可 用 "); 

} 

else{ 

Log.i(" 通 知 "," 当 前 的 网 络 连接 可 用 "); 

} 


Statestate=connManager.getNetworkInfo(ConnectivityManager.TYPE MOBILE).getState(); 
if(State.CONNECTED= =state){ 

Log.i(" 通 知 ","GPRS 网 络 已 连接 "); 

} 

state=connManager.getNetworkInfo(ConnectivityManager.TYPE WIFI).getState(); 
if(State. CONNECTED- =state){ 

Log.i(" 通 知 ","Wi-Fi 网 络 已 连接 "); 

} 

/ 跳 转 到 无 线 网 络 设置 界面 
startActivity(newIntent(android.provider.Settings. ACTION WIRELESS SETTINGS)); 
// 跳 转 到 无 限 Wi-Fi 网 络 设置 界面 
startActivity(newIntent(android.provider.Settings. ACTION WIFI SETTINGS)); 
} 


T fit TŽ ConnectivityManager 和 类 NetworkInfo 的 基本 用 法 后 ， 就 可 以 实现 判断 当前 网 
络 GPRS 和 Wi-Fi 状态 的 方法 了 。 例 如 通过 下 面 的 代码 就 可 以 实现 。 


importandroid.content.Context; 

importandroid.net.ConnectivityManager; 

importandroid.net.NetworkInfo; 

publicclassTestextendsActivity { 

privateConnectivityManagercm; 

privateNetworkInfoinfo; 

/**Calledwhentheactivityisfirstcreated.*/ 
publicvoidonCreate(BundlesavedInstanceS tate) { 
super.onCreate(savedInstanceState); 

setContentView(R.layout.main); 
cm-(ConnectivityManager)getSystemService(Context. CONNECTIVITY SERVICE); 
If(cm.getNetworkInfo(1).getState()7 —NetworkInfo.State. CONNECTED) 
1 

text.setText(" Wi-Fi 已 经 连接 "); 

} 

else{ 

text.setText(" Wi-Fi 未 连接 "); 

} 

if(cm.getNetworkInfo(0).getState()==NetworkInfo. State.CONNECTED) 


{ 
text.setText("GPRS BAI"); 
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j 

else{ 

text.setText("GPRS RIEF"); 

} 

j 

j 

通过 下 面 的 代码 可 以 判断 是 否 有 网 络 连 接 。 

public boolean isNetworkConnected(Context context) { 

if (context != null) { 
ConnectivityManager mConnectivityManager = (ConnectivityManager) context 

.getSystemService(Context. CONNECTIVITY SERVICE); 

NetworkInfo mNetworkInfo = mConnectivityManager.getActiveNetworkInfo(); 

if (mNetworkInfo != null) { 

return mNetworkInfo.isAvailable(); 


} 


j 


return false; 


} 
下 面 的 代码 可 以 判断 Wi-Fi 网 络 是 否 可 用 。 


public boolean isWifiConnected(Context context) { 
if (context != null) { 
ConnectivityManager mConnectivityManager = (ConnectivityManager) context 
.getSystemService(Context. CONNECTIVITY SERVICE); 
NetworkInfo mWiFiNetworkInfo = mConnectivityManager 
.getNetworkInfo(ConnectivityManager.TYPE WIFI); 
if (mWiFiNetworkInfo != null) { 
return mWiFiNetworkInfo.isA vailable(); 
j 
j 


return false; 


} 
下 面 的 代码 可 以 判断 Mobile 网 络 是 否 可 用 。 


public boolean isMobileConnected(Context context) { 
if (context != null) { 
ConnectivityManager mConnectivityManager = (ConnectivityManager) context 
.getSystemService(Context. CONNECTIVITY SERVICE); 
NetworkInfo mMobileNetworkInfo = mConnectivityManager 
.getNetworkInfo(ConnectivityManager. TYPE MOBILE); 
if (mMobileNetworkInfo != null) { 
return mMobileNetworkInfo.isAvailable(); 
j 
j 


return false; 
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} 
通过 下 面 的 代码 可 以 获取 当前 网 络 连 接 的 类 型 信息 。 


public static int getConnectedType(Context context) { 
if (context != null) { 
ConnectivityManager mConnectivityManager = (ConnectivityManager) context 
.getSystemService(Context. CONNECTIVITY SERVICE); 
NetworkInfo mNetworkInfo = mConnectivityManager.getActiveNetworkInfo(); 
if (mNetworkInfo != null && mNetworkInfo.isAvailable()) { 
return mNetworkInfo.getType(); 


return -1; 


13.4.2 ”在 程序 启动 时 对 网 络 状 态 进行 判断 

在 使 用 Android 系统 连接 网 络 的 时 候 ， 并 不 是 每 次 都 能 连接 到 网 络 ， 
时 候 对 网 络 的 状态 进行 判断 ， 如 果 没 有 网 络 则 及 时 提醒 用 户 进行 设置 。 要 判断 网 络 状态 ， 首 
先 需 要 有 相应 的 权限 ， 人 允许 访问 网 络 状态 权限 的 代码 如 下 。 


<uses-permission android:name="android.permission.ACCESS NETWORK. STATE"> 


</uses-permission> 
具体 的 判断 代码 如 下 。 


private boolean NetWorkStatus() { 
boolean netSataus = false; 
ConnectivityManager cwjManager = (ConnectivityManager) getSystemService 
(Context. CONNECTIVITY SERVICE); 
cwjManager.getActiveNetworkInfo(); 
if (cwjManager.getActiveNetworkInfo() != null) { 
netSataus = cwjManager.getActiveNetworkInfo().isAvailable(); 
} 


if (netSataus) { 


Builder b = new AlertDialog.Builder(this).setTitle(" 没 有 可 用 的 网 络 ") 
.SetMessage(" 是 否 对 网 络 进 行 设置 ?"); 
b.setPositiveButton(" 是 ", new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int whichButton) { 


Intent mIntent = new Intent("/"); 
ComponentName comp = new ComponentName( 
"com.android.settings", 
"com.android.settings. WirelessSettings"); 
mintent.setComponent(comp); 
mintent.setAction("android.intent.action. VIEW"); 
A 如 果 在 设置 完成 后 需要 再 次 进行 操作 ， 可 以 重 写 操作 代码 ， 在 这 里 
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startActivityForResult(mIntent,0); 


j 


}).setNeutralButton("#7", new DialogInterface.OnClickListener() f 
public void onClick(DialogInterface dialog, int whichButton) { 


dialog.cancel(); 
j 
}).show(); 
} 
return netSataus; 
} 


13.5 ”开启 或 关闭 APN 


虽然 Android 对 于 网 络 接 入 点 (Access Point Name，APN) 的 API 没有 公 


日 Ca 出 
, 但 是 参 F 


源 代码 ， 然 后 进行 数据 库 操作 ， 这 样 系统 会 自动 监听 数据 库 的 变化 ， 从 而 实现 玫 
APN。 读 者 在 获取 Android 的 源码 后 ， 可 以 重点 研究 文件 frameworks/base/core/Java/android/ 


provider/Telephony.java 中 的 类 , 此 类 
这 个 字段 可 以 在 文件 Telephony.jav 


下 面 的 演示 代码 实现 了 如 下 


nz 


个 功能 。 


C1) 当 开 局 APN 的 时 候 ， 设 置 一 个 正确 的 移动 或 者 联通 的 APN。 


(2) 关闭 的 时 候 设 置 一 个 错误 APN 就 会 自动 关闭 网 络 。 
首先 定义 继承 于 Activity 的 类 Main， 代 码 如 下 。 


package cc.mdev.Demo; 
import java.util. ArrayList; 
import java.util List; 

import android.app.Activity; 


import android.content.Content Values; 


import android.database.Cursor; 


import android.net.Uri; 
import android.os.Bundle; 
import android.util.Log; 
import android.view.View; 
import android.widget.Button; 


public class Main extends Activity { 


Uri uri = Uri.parse("content://telephony/carriers"); 


@Override 


public void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 


setContentView(R.layout.main); 
Button open- (Button) find ViewByld(R.id.open); 
Button close- (Button) findViewById(R.id.close); 
open.setOnClickListener(new View.OnClickListener() { 
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[局 或 者 关闭 


的 核心 是 URI 和 数据 库 字 段 “ content://telephony/carriers”， 
a 中 找到 。 
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@Override 
public void onClick(View v) { 
openAPN(); 
} 
Dp 
close.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 


closeAPN(); 

} 

J) 

} 
public void openAPN()( 

List list = getAPNList(); 
for (APN apn: list) { 

ContentValues cv = new ContentValues(); 
cv.put("apn", APNMatchTools.matchA PN(apn.apn)); 
cv.put("type", APNMatchTools.matchA PN(apn.type)); 
getContentResolver().update(uri, cv, "_id=?", new String[] {apn.id}); 

j 


} 
public void closeAPN(){ 


List list = getAPNList(); 
for (APN apn: list) { 
ContentValues cv = new ContentValues(); 
cv.put("apn", APNMatchTools.matchAPN(apn.apn)+"mdev"); 
cv.put("type", APNMatchTools.matchA PN(apn.type)+"mdev"); 
getContentResolver().update(uri, cv, "_id=?", new String[] {apn.id}); 
j 
j 
private List getAPNList() { 
String tag = "Main.getAPNList()"; 
//current 不 为 空 表示 可 以 使 用 的 APN 
String projection[] = {"_id,apn,type,current"}; 
Cursor cr = this.getContentResolver().query(uri, projection, null, null, null); 
List list = new ArrayList(); 
while(cr!=null && cr.moveToNext()) { 
Log.d(tag, cr.getString(cr.getColumnIndex(" 1d")) + " " + er.getString(cr.getColumnIndex("apn")) + 
" " + er.getString(cr.getColumnIndex("type"))+ " " + cr.getString(cr.getColumnIndex("current"))); 
APN a= new APNO); 
a.id = cr.getString(cr.getColumnIndex("_id")); 
a.apn = cr.getString(cr.getColumnIndex("apn")); 
a.type = cr.getString(cr.getColumnIndex("type")); 
list.add(a); 
} 
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if(cr!=null) 
cr.close(); 
return list; 


j 


public static class APN( 


String id; 
String apn; 
String type; 
j 

j 


然后 实现 不 同 运营 商 的 APN， 演 示 代 码 如 下 。 
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package cc.mdev.apn; 
public final class APNMatchTools 1 
public static class APNNet( 


/* 


* 中 国 移动 emwap 


if 


public static String CMWAP = "cmwap"; 


[FE 


* 中 国 移动 cmnet 


wj 


public static String CMNET = "cmnet"; 


/中 


DO 3GWAP 设置 中 国联 通 3G 


特 网 设 


中 


国联 通 WAP 设置 中 


国联 通 因特网 设 


//3gwap 3gnet uniwap uninet 


JS 


联通 


*3G wap 中 国 
E 


public static String GWAP 3 = "3gwap"; 


JS 


3gwap APN 


* 3G net 中 国联 通 3gnet APN 


sil 


public static String GNET 3-"3gnet"; 


JS 


* uni wap 中 国 


联通 uni wap APN 


"i 
public static String U 
JS 


INIWAP="uniwap"; 


* uni net 中 国联 通 uni net APN 


Si 


public static String U 


j 


ININET-"uninet"; 


public static String matchAPN(String currentName) { 


if("".equals(currentName) || null==currentName) { 


return 


j 


"m. 
j 
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currentName = currentName.toLowerCase(); 
if(currentName.starts With(APNNet.CMNET)) 
return APNNet.CMNET; 
else if(currentName.startsWith(A PNNet.CMWAP)) 
return APNNet.CMWAP; 
else if(currentName.starts With(APNNet.GNET_3)) 
return APNNet.GNET 3; 
else if(currentName.starts With(APNNet.GWAP 3)) 
return APNNet.GWAP 3; 
else if(currentName.starts With(APNNet. UNINET)) 
return APNNet.UNINET; 
else if(currentName.starts With( APNNet. UNIWAP)) 
return APNNet. UNIWAP; 
else if(currentName.startsWith("default")) 
return "default"; 
else return ""; 

} 

} 
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微 博 是 微 博客 (MicroBlog) 的 简称 
用 户 可 以 通过 Web. WAP 以 及 各 种 客 
D, dAn erh, ran? 
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在 当前 的 互联 网 时 代 中 ， 使 月 


(1) 微 博 的 特点 


开发 移动 微 睛 应 用 程序 


微 博 广 泛 分 布 在 桌面 、 浏 览 器 、 


成 多 个 垂直 细 分 领域 的 可 能 。 但 是 无 论 哪 种 商业 模式 ， 都 离 不 天 


(2) 手机 微 博 
微 博 的 主要 发 展 平 台 是 手记 


无 线 的 手机 连 在 一 起 ， 让 每 个 手机 


友 分 享 自己 的 快乐 。 


L, 


3&, D140 ZEA 


日 微 博 的 用 户 越 来 越 多 ， 最 早 的 微 博 是 美 
相关 公开 数据 ， 和 截至 2010 年 1 月 份 ， 该 产品 在 全 球 已 经 拥有 7500 77 
份 中 国 最 大 的 门户 网 站 新 浪 网 推出 “新 浪 微 博 ”内 测 版 ， 成 为 门户 网 站 
务 的 网 站 ， 从 此 微 博 正式 进入 人 们 视野 。 


服务 器 以 手机 为 平台 ， 把 每 个 手机 用 户 用 


基于 用 户 关系 的 信息 分 享 、 传 播 以 及 获取 平台 ， 
的 文字 更 新 显示 信息 ， 并 实现 即 
开发 微 博 项 目的 基本 知识 。 


四 的 Twitter， 根据 
A. 2009 年 8 H 
PP 第 一 家 提供 微 博 服 


多 个 平台 上 ， 有 多 种 商业 模式 并 存 ， 并 有 形 
F 用 户 体 验 的 特性 和 基本 功能 。 


昌 户 不 再 使 用 计算 机 就 可 以 发 布 自己 的 最 新 信 ， 


已， 并 和 好 


微 博之 所 以 要 限定 140 个 字符 ， 就 是 源 于 从 手机 发 短信 最 多 的 字符 就 是 140 个 。 由 此 可 
见 ， 微 博 从 诞生 之 初 就 同 手机 密 不 可 分 ， 这 更 是 在 互联 网 形态 中 最 大 的 亮点 。 微 博 对 互联 网 
的 重大 意义 就 在 于 建立 了 手机 和 互联 网 应 用 的 无 颖 连接, 培养 手机 用 户 使 用 手机 上 网 的 习惯 ， 


增强 移动 端 同 互 联网 的 互动 ， 从 而 使 手机 用 户 顺利 过 渡 到 无 线 互 联网 月 
手机 和 微 博 应 用 有 如 下 三 种 结合 


口 通过 短信 和 彩信 


短 、 彩 信 形 式 是 同 移动 运营 
Beaks 
E 


形式 。 


Rate, H 


昌 户 所 花 的 短 、 彩 信 费 月 


敌 盖 的 人 群 比较 广泛 ， 只 要 


云 
已 
E 

EI 


限制 SOKB 大 小 的 次 端 严重 影响 了 图 


短信 就 能 更 新 微 博 。 但 对 月 
片 的 清晰 度 。 最 关键 


前 应 用 中 ， 


日 由 运营 商 收 取 ， 这 种 形式 
户 来 说 更 新 成 本 太 大 ， 并 且 彩 信 


口 通过 WAP 版 网 站 


各 微 博 网 站 基本 都 有 自己 的 WAP R, P 
上 网 就 


WAP 版 。 这 种 形式 只 要 手机 能 


法 看 到 其 他 人 的 更 新 ， 这 种 单 向 的 信息 传输 方式 大 大 降低 了 月 


的 是 这 种 方式 只 能 提供 更 新 ， 而 无 
HA 的 参与 感 和 互动 性 。 


Hu EG EXE WAP 或 通过 安装 客户 端 连接 到 


， 就 可 以 更 新 也 可 以 浏览 、 回 


复 和 评论 ， 


所 需 费 用 也 就 是 浏览 过 程 中 所 用 的 流量 费 。 但 目前 国内 的 流量 费 还 相对 较 高 ， 网 速 也 相对 较 


慢 ， 如 果 要 上 传 大 图 片 ， 速 度 会 非常 慢 。 


14.2 


者 步 入 本 


C 通过 手机 客户 端 
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手机 客户 端 分 如 下 两 种 。 
e 微 博 网 站 开发 的 基于 WAP 的 快捷 方式 版 。 用 户 通 过 客户 端 直接 连接 到 经 过 美化 和 优 


化 的 WAP 版 微 博 网 站 。 这 种 形式 的 月 


快捷 方式 。 
e 利用 微 博 网 站 提 


E API 开发 的 第 三 方 客户 端 。 


Twitter 开发 的 ， 


需要 通过 主动 联网 登 阳 


日 户 行为 依赖 于 用 户 的 主动 性 ， 也 就 是 用 户 想 更 
新 和 浏览 微 博 的 时 候 才 会 打开 客户 端 ， 其 实 也 就 相当 于 在 手机 端 增加 了 一 个 微 博 网 站 


国际 上 比较 有 名 的 是 Twitter 的 客户 
端 ， 国 内 比较 著名 的 是 新 浪 和 Hesine〈 和 信 ) 提供 的 客户 端 。 其 中 Gravity 是 专门 为 
的， 但 操作 架构 和 界面 经 过 合理 设计 ， 用 户 体 
验 非常 好 。 和 信和 是 国内 公司 开发 的 , 目前 不 但 支持 Twitter, 还 支持 国内 的 各 3 
与 其 他 客户 端 不 同 的 是 ， 和 信 的 客户 端 是 
不 但 能 够 大 大 提升 用 户 更 新 微 博 的 速度 ， 而 且 能 将 微 博 消息 
户 不 用 主动 登陆 微 博 就 能 实现 浏览 杂 
在 非 智 能 机 上 的 体验 还 不 是 很 好 。 而 新 浪 微 博 的 API 平台 
户 及 关系 在 内 的 二 十 余 类 接口 ， 深 受 国内 程序 员 的 喜好 。 


微 博 开发 必 备 技术 介绍 


mn, 
I 用 IP Push 技术 提供 微 博 更 新 和 下 发 通道 ， 
# 送 到 用 户 的 手机 中 ， 用 
1 互动 。 和 信 支 持 的 系统 平台 比较 多 ， 但 是 缺点 是 
开放 了 包括 微 博 、 评 论 、 用 


在 本 节 的 内 容 中 ， 将 简单 介绍 在 Android 平台 中 开发 微 博 系统 所 需要 的 基本 技术 ， 为 读 


后 面 知 识 的 学 习 打 下 基础 。 
14.2.1 XML-RPC 技术 


开发 微 博 应 用 程序 的 关键 技术 是 RPC，RPC 是 Remote Procedure Call 
程 过 程 调用 ”。XML-RPC 是 一 种 统一 标准 的 规范 ， 
符合 XML-RPC 格式 的 请 求 来 调用 远程 服务 器 上 的 某 个 程 
多 网 络 服务 业者 都 会 以 XML-RPC 的 方式 提供 给 软件 3 
能 够 根据 业者 定义 好 的 方式 ， 以 XML-RPC 的 方式 来 使 用 该 网 站 的 某 些 功能 。 
中 的 微 博 也 都 支持 XML-RPC 的 介 接 方式 。 
DK XML-RCP 工具 把 传 入 的 参数 组 合成 XML， 然 后 用 通过 HTTP 协议 
发 给 服务 器 ， 服 务 器 回复 XML 格式 数据 ， 再 由 专业 工具 解析 给 调用 者 。 


XML-RPC HJE H 


E nyuk 


JEI IN 


在 XML-RPC 标准 ， 


， 规 定 XML 内 容 的 规则 如 下 。 


«xml version=”1.0’?> 


<methodCall> 


<methodName> 要 调用 的 method name</methodName> 


<params> 


<params> 参 数 1</param> 


<params> 参 数 2</param> 


<param> 参 数 n</param> 


</params> 
</methodCall> 


Ee 序 ， 进 而 运行 微 博 的 功能 。 
于 发 者 一 个 系统 介 接 的 管道 ， 


HTTP 的 方式 连接 运行 的 ， 以 传送 


现在 许 


让 开发 者 
当前 许多 市 面 
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Android 本 身 并 不 支持 XML-RPC 协议 ， 需 要 下 载 相应 的 工具 。 读 者 可 以 从 如 下 地 址 下 载 
XML-RPC 相关 工具 。 


http://code.google.com/p/android-xmlrpc/downloads/list 


下 面 的 代码 演示 了 使 用 XML-RPC 协议 实现 微 博 客户 端的 基本 过 程 。 


package org.xmlrpc; 
import java.net.URI; 
import java.util.HashMap; 
import java.util.Map; 
import org.apache.http.conn.HttpHostConnectException; 
import org.xmlrpc.android.XMLRPCClient; 
import org.xmlrpc.android.X MLRPCException; 
import org.xmlrpc.android.X MLRPCFault; 
import org.xmlrpc.android.X MLRPCSerializable; 
import android.app.Activity; 
import android.content.Context; 
import android.os.Bundle; 
import android.util.Log; 
import android.widget.EditText; 
import android.widget. Toast; 
import android.widget.Button; 
import android.content.DialogInterface.OnCancelListener; 
import android.view. View.OnClickListener; 
import android.view. View; 
public class TestBlog extends Activity { 
private XMLRPCClient client; 
private URI uri; 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.test blog); 
Button btn = (Button) findViewByld(R.id.send); 
btn.setOnClickListener(new OnClickListener() { 
public void onClick( View v) { 
post(); 


m 


void post() { 
String blogid = ((EditText) findViewBylId(R.id.blogid edit)).getText() 
toString(); /ID， 
String username = ((EditText) findViewById(R.id.username edit)) 
getText()toString(; /用户 名 
String password = ((EditText) findViewById(R.id.password edit)) 
.getText().toString();  // 密码 
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String title = ((EditText) 
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findViewBylId(R.id.title edit)).getText() 
toString(); /标题 


String content = ((EditText) find ViewByld(R.id.content_edit)).getText() 


toString(); H TES 


uri = URI create("http://blog.csdn.net/" + blogid 


+ "/services/metablogapi.aspx"); 


client = new XMLRPCClient(uri); 
Map<String, Object> structx = new HashMap<String, Object>(); 


structx.put("title", title); 
structx.put("description" 


, content); 


Object[] params = new Object[] { blogid, username, password, structx, 


true }; 


try { 


client.callEx("metaWeblog.newPost", params); 
Toast.makeText(this, "OK", 10000).show(); 

} catch (XMLRPCException e) { 
Toast.makeText(this, "ERROR" + e, 10000).show(); 


j 


14.22 Meta Weblog API 客户 端 


Meta Weblog API 是 博客 园 发 布 的 一 款 功 能 强大 的 客户 端 ， 其 登录 地 址 是 : 
http;//www.cnblogs.com/« H] P! 名 >/services/metaweblog.aspx o Meta Weblog API 支持 通过 


XML-RPC 的 方法 在 软件 


编辑 及 浏览 日 志 ， 其 中 最 为 常用 的 API 如 下 。 


口 发 布 新 文章 (metaWeblog.newPost)。 
口 获取 分 类 (metaWeblog.getCategories)。 


Ooo 


最 新 文章 (netaWeblog.getRecentPosts)。 
新 建文 章 分 类 (wp.newCategory)。 
上 传 图 片 音频 或 视频 (metaWeblog.newMediaObjecb。 


14.3 ”分析 腾讯 Android 版 微 博 API 


作为 一 名 Android 学 习 者 来 说 ， 独 立 开 发 微 博 系统 的 难度 比较 大 。 


博 系统 的 开源 代码 ， 开 发 人 员 利 用 它 1 


微 博 系统 。 比 较 有 代表 性 的 Android 版 的 微 博 系 统 有 新 浪 微 博 和 腾讯 微 博 。 在 本 节 的 内 容 ， 


将 首先 讲解 腾讯 微 博 系统 的 API 接 
14.3.1 源码 和 jar 包 下 载 


包 ， 此 包 适 用 于 Android RA. EEH 


门 提供 的 API 接口 ， 就 可 以 方便 的 


当前 可 以 获取 很 多 微 
开发 出 Android 版 的 


因为 当前 腾讯 微 博 提供 的 Java(Android) SDK 功能 过 低 ， 所 以 特意 集成 了 一 个 Java SDK 
包含 了 腾讯 微 博大 部 分 的 API，: 


E 要 特点 如 下 。 
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口 用 法 简单 : 微 博 、 评 论 、 转 发 、 私 信 同 一 个 实体 类 。 

O 方便 扩展 : 可 以 根据 需要 修改 源 代码 或 是 继承 QqTSdkService 类 ， 为 了 能 升级 版 本 建 
议 采 用 继承 的 方式 。 

在 压缩 包 Java SDK 中 ，QqTAndroidSdk-1.0.0.jar 是 SDK 的 主 代码 ， 其 

ServiceImpl 包含 了 所 有 接口 的 实现 。 各 个 包 的 有 具体 说 明 如 下 。 

QO QqTAndroidSdk-1.0.0.jar: 这 是 主 程序 代码 ， 可 以 直接 解压 缩 查 看 源码 。 

O google code 源码 的 下 载 地 址 : http://code.google.com/p/qq-t-java-sdk/source/browse/。 

口 github 源码 的 下 载 地 址 ，https://github.com/Trinea/qq-t-java-sdk。 

O 压缩 包 JavaCommon-1.0.0.jar: 是 QqTAndroidSdk 依赖 的 公用 处 理 包 ， 
list、 数 组 、map、json 工具 类 等 。 


14.3.2 具体 使 用 


在 具体 使 用 之 前 ， 先 参考 腾讯 微 博 的 API 文档 说 明 ， 地 址 是 : http://wiki.open.qq. 
com/wiki/website/API%E5%88%97%E8%A1%A8， 如 图 14-1 所 示 。 


中 QqTSdk- 


包含 了 字符 串 、 


o 腾讯 向 二 开放 平台 
开放 平台 API 文 档 返回 
Mei 注意 : 以 下 接口 使 用 说 明文 档 均 是 以 oauth1.0 鉴 权 为 例 进行 说 明 的 ， 因 此 调用 接口 时 使 用 的 是 http 方 式 ,而 
组 件 使 用 指引 如 果 您 选择 使 用 oauth2.a 鉴 权 ， 那 么 调用 接口 时 请 换 成 https 请 求 方式 。 
应 用 接 入 指引 
OAuth 授 权 时 间 线 微 博 相关 帐户 相关 关系 链 相 关 
应 用 频道 接 入 指引 
私信 相关 ER» 热度 ,趋势 数据 更 新 相关 EE 
移动 应 用 接 入 Mate 搜索 相关 Bm 数据 更 新 相 数据 收藏 
开发 者 协议 话题 相关 标签 相关 名 单 RBS LBS 相 关 
AARETE 其 他 文档 更 新 历史 API 问 题 QA RBH SEPETE 
OAuth 授 权 
授权 
request token 获取 request token 
OAuth oat authorize 用 户 授权 request token 
OAuth2.0 鉴 权 


access_token 交换 access token 


OpenId&OpenKey 鉴 权 


点 击 查看 示例 APpI 请 求 示例 说 明 
API 接 口 

时 间 线 
API 文 档 statuses/home timeline 主页 时 间 绪 
一 API Ed e 

amm E statuses/public_timeline 广播 大 厅 时 间 线 

ApI 调 用 权限 说 明 

statuses/user timeline 其 他 用 户 发 表 时 间 线 
API 调试 工具 

statuses/mentions timeline RAPER 
OpenJSUS 接 口 ) 


在 编码 使 用 API 时 ， 都 需要 儿 


的 初始 化 代码 。 
[** 
* 分 别 设 


TH 


* 请 用 自己 的 村 


kd 


gek 


S 


14-1 


腾讯 微 博 
新建 QqTSdkService 类 对 象 并 进行 初始 化 工作 。 例 如 下 面 


的 API 文档 页 再 


QqTAppAndToken qqTAppAndToken = new QqTAppAndToken(); 
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目的 key、secret( 腾 讯 提供 )。 用 户 的 accesstoken 和 tokenSecret(OAuth 获取 ) 
替换 ， 和 否则 无 法 成 功 发 送 和 获取 数据 
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qqTAppAndToken.setAppKey("***"); // *** 用 应 用 key 替换 
qqTAppAndToken.setAppSecret("***"); // *** 用 应 用 secret 替换 
qqTAppAndToken.setAccessToken("***"); // *** 用 用 户 accesstoken SS hi 


qqTAppAndToken.setTokenSecret("***"); A *** 用 用 户 tokenSecret 替换 


/** 新 建 QqTSdkService 对 象 ， 并 设置 应 用 信息 和 用 户 访问 信息 **/ 
QqTSdkService qqTSdkService = new QqTSdkServiceImpl(); 
qqTSdkService.setQqTAppAndToken(qqTAppAndToken); 


接 下 来 开始 对 接口 进行 详细 介绍 ， 并 讲解 使 用 QqTAndroidSdk-1.0.0.jar 中 的 API 的 方法 。 


腾讯 微 博 中 的 接口 主要 分 成 下 面 的 几 大 类 。 


H 


d' 


XA 4 
C1) 
(2) 
(3) 
(4) 


1. 时 间 线 〈 微 博 列表 ) 
这 里 的 20 个 接口 包含 了 腾讯 微 博 的 如 下 四 个 部 分 的 API 


时 间 线 中 ， 除 statuses/ht timeline ext〔 话 题 时 间 线 〉 以 外 的 15 个 API. 
私信 相关 中 ， 收 件 箱 、 发 件 箱 的 两 个 API。 

数据 收藏 中 ， 收 藏 的 微 博 列表 和 获取 已 订阅 话题 列表 的 两 个 API。 
微 博 相关 中 ， 获 取 单 条 微 博 的 转发 或 点 评 列表 的 API。 


以 获取 首页 信息 为 例 ， 示 例 代码 如 下 。 


ix 
取 更 多 时 
2. 微 博 新 增 API 
在 本 书 成 稿 时 ， 腾 讯 微 博 新 增加 了 8 个 API， 分 别 是 在 微 博 相关 中 的 发 表 一 条 微 博 、 转 
一 条 微 博 、 回 复 一 条 微 博 、 发 表 一 条 带 图 片 微 博 、 点 评 一 条 微 博 、 发 表 音 乐 微 博 、 发 表 视 


OqTTimelinePara qqTTimelinePara = new QqTTimelinePara(); 

/** 设置 分 页 标识 **/ 

qqTTimelinePara.setPageFlag(0); 

pee 设置 起 始 时 间 **/ 

qqTTimelinePara.setPageTime(0); 

Jr 每 次 请 求 记录 的 条 数 **/ 
qqTTimelinePara.setPageReqNum(QqTConstant. VALUE PAGE REQ NUM); 

[** 可 以 设置 拉 取 类 型 ， 可 取 值 QqTConstant 中 VALUE STATUS TYPE TL = **/ 
qqTTimelinePara.setStatusType(QqTConstant. VALUE STATUS TYPE TL ALL); 

pee 可 以 设置 微 博 内 容 类 型 ， 可 取 值 QqTConstant H VALUE CONTENT TYPE TL- **/ 
qqTTimelinePara.setContentType(QqT Constant. VALUE CONTENT TYPE TL ALL); 
List<QqTStatus> qqTStatusList = qqTSdkService.getHomeTL(qqT TimelinePara); 
assertTrue(qqTStatusList != null); 


f qqTStatusList 就 保存 了 首页 的 20 条 数据 ,可 以 自行 设置 不 同 的 类 型 参数 。 如 果 想 获 


间 线 数据 ， 请 读者 参考 腾讯 微 博 Java(Android) SDK 时 间 线 API 的 详细 介绍 。 


频 微 博 、 发 表 心 情 帖 子 。 在 新 的 API 中 发 表 一 条 微 博 和 发 表 一 条 带 图 片 微 博 的 操作 合 二 为 一 。 
另外 ， 还 新 增 了 私信 相关 中 的 发 私信 操作 一 条 微 博 的 功能 ， 以 新 增 一 条 微 博 为 例 ， 演 示 
代码 如 下 。 


qqTSdkService.addStatus(" 第 一 条 状态 哦 " null); 
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其 中 第 一 个 参数 为 状态 内 容 ， 第 二 个 参数 为 图 片 地 址 ， 不 传 图 片 为 空 即 可 。 或 者 在 如 下 


复杂 代码 中 ，status 可 以 设置 其 他 地 理 位 置信 息 。 


OqTStatusInfoPara status = new QqTStatusInfoPara(); 
status.setStatusContent(" 4€ — 2&tt KI Fr tnt [69b " ); 

P* AES. SEES 

status.setImageF ilePath("/mnt/sdcard/DCIM/Camera/IMAG2150.jpg"); 
assertTrue(qqT SdkService.addStatus(status, qq T AppAndToken)); 


3. 操作 一 条 微 博 

C1) 在 微 博 相 关中 ， 删 除 一 条 微 博 的 API。 

(2) 在 私信 相关 中 ， 删 除 私信 的 API 

(3) 在 数据 收藏 中 ， 收 藏 微 博 、 取 消 收藏 微 博 、 订 阅 话题 、 取 消 订 阅 话题 的 4 个 API。 
以 收藏 一 条 微 博 为 例 ， 示 例 代 码 如 下 : 


qqTSdkService.collect(12121); 


中 参数 为 微 博 id。 

4. KAHIR AAIR) 

这 10 个 接口 包含 腾讯 微 博 关 系 链 相 关中 的 互 听 关 系 链 列表 〈 对 某 个 用 户 而 言 ， 既 是 他 的 
听众 又 被 他 收听 )、 其 他 帐号 听众 列表 、 其 他 帐号 收听 的 人 列表 、 其 他 帐户 特别 收听 的 人 列表 、 
黑 名 单列 表 、 我 的 听众 列表 、 我 的 听众 列表 (只 包含 名 字 )、 我 收听 的 人 列表 、 我 收听 的 人 列 
表 ( 只 包含 名 字 )、 我 的 特别 收听 列表 。 

以 获取 自己 的 收听 用 户 为 例 ， 示 例 代 码 如 下 。 


QqTUserRelationPara qqTUserRelationPara = new QqTUserRelationPara(); 
qqTUserRelationPara.setReqNumber(QqTConstant. VALUE PAGE REQ NUM); 
qqTUserRelationPara.setStartIndex(0); 

List<QqTUser> qqTUserList = qqTSdkService.getSelfInterested(qqTUserRelationPara); 


5. 用 户 建立 关系 

这 6 个 接口 包含 腾讯 微 博 关 系 链 相 关中 的 收听 某 个 用 户 、 取 消 收 听 某 个 用 户 、 特 别 收 听 
某 个 用 户 、 取 消 特别 收听 某 个 用 户 、 添 加 某 个 用 户 到 黑 名 单 、 从 黑 名 单 中 删除 某 个 用 户 。 

以 关注 茶 些 用 户 为 例 ， 示 例 代 码 如 下 。 


qqTSdkService.interestedInOther("Wenzhang,li_nian,mayili007", null) 


6. 帐户 相关 

这 7 个 接口 包含 腾讯 微 博 帐 户 相 关中 的 获取 自己 的 详细 资料 、 更 新 用 户 信 息 、 更 新 用 户 
头像 信息 、 更 新 用 户 教育 信息 、 获 取 其 他 人 资料 、 获 取 一 批 人 的 简单 资料 、 验 证 账户 是 否 合 
法 (是 否 注 册 微 博 )。 

以 获取 目 己 的 资料 为 例 ， 示 例 代码 如 下 。 


QqTUser qqTUser = qqTSdkService.getSelfInfo(); 
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7. 搜索 相关 
这 3 个 接口 包含 腾讯 微 博 搜索 相关 中 的 搜索 用 户 、 搜 索 微 博 、 通 过 标签 搜索 用 户 。 以 搜 
索 微 博 为 例 ， 示 例 代 码 如 下 。 


] 


public void testSearchStatus() { 
OqTSearchPara qqTSearchPara = new QqTSearchPara(); 
qqTSearchPara.setK eyword("iphone"); 
qqTSearchPara.setPage( 1); 
qqTSearchPara.setPageSize(QqTConstant. VALUE PAGE REQ NUM); 
List<QqTStatus> qqTStatusList = qqTSdkService.searchStatus(qqTSearchPara); 
assertTrue(qqTStatusList != null); 


} 
8. 热度 趋势 相关 
这 两 个 接口 包含 腾讯 微 博 热 度 趋势 
例 代码 如 下 。 


et 


FP 的 话题 热 榜 、 转 播 热 榜 用 户 。 以 话题 热 榜 为 例 ， 示 


public void testGetHotTopics() { 
QqTHotStatusPara qqTHotStatusPara = new QqTHotStatusPara(); 
qqTHotStatusPara.setReqNum(QqTConstant. VALUE PAGE REQ NUM); 
qqTHotStatusPara.setLastPosition(0); 


(E 
*1 话题 名 ，2 搜索 关键 字 3 两 种 类 型 都 有 
xk 


qqTHotStatusPara.setType(Integer.toString(1)); 
List<QqTTopicSimple> hotTopicsList = qqTSdkService.getHotTopics(qqTHotStatusPara); 
assertTrue(hotTopicsList != null); 


j 


9. 数据 更 新 
这 一 个 接口 为 腾讯 微 博 数据 更 新 相关 中 的 查看 数据 更 新 条 数 ， 示 例 代 码 如 下 。 


public void testGetUpdateInfoNum() { 
/** 设置 clearType， 对 应 QqTConstanL VALUE CLEAR TYPE … **/ 
QqTUpdateNumInfo qqTUpdateNumlInfo = qqTSdkService.getUpdateInfoNum(true, QqTConstant. 
VALUE CLEAR TYPE HOME PAGE); 
assertTrue(qqTUpdateNumInfo != null); 


j 
10. 发 起 话题 
这 两 个 接口 是 为 腾讯 微 博 中 的 话题 应 用 服务 的 , 可 以 根据 话题 名 称 查询 话题 ID 和 根据 话 
题 ID 获取 话题 相关 信息 。 示 例 代码 如 下 。 


public void testGetTopicInfoBylds() { 
Pee 先 得 到 话题 id **/ 
Map<String, String> topicIdAndName = qqTSdkService.getTopicIdByNames(" x ij I] 48, 21 T 5i 
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"FA iphone"); 
if (topicIdAndName != null) { 
/** id, US **/ 


List<QqTStatus> qqtStatusList = qqTSdkService.getTopicInfoBylds(ListUtils.join(new 
Array List<String>(topicldAndName.keySet()))); 


assertTrue(qqtStatusList != null); 
} else { 


assertTrue(false); 
} 
} 


11. 标签 相关 
这 两 个 接口 为 腾讯 微 博 标签 相关 中 的 添加 标签 条 


[删除 标签 API， 示 例 代 码 如 下 。 
public void testDeleteTag() { 


Is 删除 自己 的 tag， 先 获取 自己 的 资料 ， 从 中 取 中 tag id **/ 
OqTUser qqTUser = qqTSdkService.getSelfInfo(); 


if (qqT User != null && qqTUser.getTagMap() != null && qqTUser.getTagMap().size() > 0) { 
/** 删除 tag **/ 


for (Map.Entry<String, String> tag ` qqTUser.getTagMap().entrySet()) { 
qqTSdkService.deleteTag(tag.getKey()); 
j 


} else { 


assertTrue(false); 


j 


14.4 详解 Android 版 新 浪 微 博 


新 浪 微 博 在 国内 较 早 地 推出 微 博 应 用 。 读 者 可 以 登录 http:/open.weibo.com/wiki/SDK 3X 
取 在 Android 平台 使 用 新 浪 微 博 的 详细 资料 ， 在 网 站 中 也 可 以 获取 开源 代码 。 
在 Android 中 使 用 新 浪 微 博 开发 平台 API 的 基本 步 又 如 下 。 
1. 通过 官方 网 址 下 载 SDK 
当前 的 最 普遍 版 本 是 3.1.1， 下 载 页 面 的 地 址 是 : 
http://open. weibo.com/wiki/SDK#AndroidSDK 
此 页 面 的 界面 效果 如 图 14-2 所 示 。 
2. 认证 
在 SDK' 


有 完整 的 如 何 通 过 oauth 认证 的 演示 实例 ， 认 订 


E 和 使 用 流程 如 下 。 
(1) 在 /weibo4android/src/weibo4android/Weibo.java 设置 App Key 和 App Secret (在 官方 
网 站 新 建 应 用 可 获得 )。 


public static String CONSUMER_KEY = "2664209963"; 
public static String CONSUMER_SECRET = "b428615797a5d676d428cd146c040399"; 
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(2) fE/weibo4android/examples/weibo4android/androidexamples/AndroidExample.java 中 ， 
将 App Key 和 App Secret 设置 到 系统 类 中 。 
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GitHub This repository Explore Features Enterprise 
sinaweibosdk / weibo_android_sdk Gu 

新 浪 微 博 Android SDK 
XD 63 commits i» 2 branches 6 releases fp 3 ct 


Branch: mastery weibo_android_sdk /+ 


3.1.2 补 充 文 档 


lp; zhangqi12 authored on Aug 14 Imtest commi! 
lili demo-src 3.1.2 版 本 发 布 

Bi lib: 3.1.2 版 本 发 布 

lll raw/FAQ/screenshot 

EI gitattributes Ww 

E] README.md 3.1.1 发 布 

国 WeiboSDKDemo_v3.1.2.apk 3.1.2 版 本 发 布 

EI app_signatures.apk WeiboSDK V2.3.0 

=) debug.keystore WeiboSDK V2.3.0 

EI weiboSDKCore 3.1.2 jar 3.12 3 Em 


图 14-2 FÆ SDK 页 面 


a 


System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 


(3) 通过 HTTP POST 方式 向 服务 提供 方 请 求 获得 RequestToken. 


RequestToken requestToken =weibo.getOAuthRequestToken("weibo4android://OAuthActivity"); 


(4) 将 月 


日 户 引 导 至 授权 页 面 。 


Uri uri = Uri.parse(requestToken.getAuthenticationURL()+ "&display=mobile"); 
startActivity(new Intent(Intent ACTION VIEW, uri)); 


(5) 授权 页 面 要 求 用 户 输 入 用 户 名 和 密码 ， 授 权 完 成 后 ， 服 务 提 供 方 会 通过 回 


用 户 引 导 回 


客户 端的 OAuthActivity 页 面 。 


<activity android:name=".OAuthActivity"> 
<intent-filter> 
<action android:name="android.intent.action.VIEW" /> 
<category android:name="android.intent.category.DEFAULT" /> 
«category android:name="android.intent.category.BROWSABLE" /> 
«data android:scheme-"weibo4android" android:host="OAuthActivity" /> 


iil URL 将 
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</intent-filter> 


</activity> 


(6) 客户 端 根 据 临时 令 牌 和 用 户 授权 码 从 服务 提供 方 那里 获取 访问 令 牌 (Access Token). 


(7 


NM 


Uri uri-this.getIntent().getData(); 
RequestToken requestToken- OAuthConstant.getInstance().getRequestToken(); 
AccessToken  accessToken-requestToken.getAccessToken(uri.getQueryParameter("oauth verifier"); 


获得 访问 令 牌 后 便 可 使 用 APT 接口 获得 和 操作 用 户 数据 。 


Weibo weibo=OAuthConstant.getInstance().getWeibo(); 
weibo.setToken(OAuthConstant.getInstance().getToken(), OAuthConstant.getInstance().getT okenSecret()); 
String[] args = new String[2]; 
args[0]=OAuthConstant.getInstance().getToken(); 
args[1]-OAuthConstant.getInstance().getTokenSecret(); 
try { 

GetFollowers.main(args);/ 返 回 用 户 关 注 对 象 列表 ， 并 返回 最 新 微 博文 章 
} catch (Exception e) { 


e.printStackTrace(); 


j 


在 上 述 步骤 中 ，weibo4android 是 XML 文件 中 定义 的 索引 名 ,在 上 面 步骤 (5) 中 的 XML 
代码 中 ，<data android:scheme="weibo4android" android:host="OAuthActivity" 这 部 分 的 索引 名 


是 自 定 义 的 ， 与 Java 代码 中 的 URL 相 匹 配 即 可 
在 本 书 接 下 来 的 内 容 中 ， 将 不 再 剖析 Android 版 新 浪 微 博 的 实现 源码 ， 而 是 以 此 为 基础 ， 


讲解 二 次 扩展 开发 的 基本 知识 。 


14.4.4. 新 浪 微 博 图 片 缩放 的 开发 实例 


在 Android 开发 过 程 中 ， 有 时 会 用 到 图 片 缩放 效果 ， 即 单 击 图 片 时 显示 缩放 按钮 ， 一 定 


时 间 后 自动 消失 。 接 下 来 将 根据 新 浪 微 博 的 图 片 缩放 原理 


ho 


编写 演示 代码 。 


C1) UI 布局 文件 的 演示 代码 如 下 。 
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<?xml version="1.0" encoding="utf-8"?> 
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: orientation="Vertical" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
android:id="(@+id/layout1" 
> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:id="@-+id/rl" 
> 


<ScrollView xmlns:android="http://schemas.android.com/apk/res/android" 
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android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
android: layout_weight="19" 
android:scrollbars="none" 
android:fadingEdge-" vertical" 


android:layout_gravity="center" 


android: gravity="center" 


> 

<HorizontalScroll View 
android:layout_height="fill_parent" 
android:layout_width="fill_parent" 
android:scrollbars="none" 

android:layout_gravity="center" 

android: gravity="center" 

android:id="(@+id/hs" 

> 

<LinearLayout 
android: orientation="horizontal" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:id="(@+id/layoutImage" 
android:layout_gravity="center" 
android:gravity="center" 
> 


<Image View 


android:layout_gravity="center" 

android:gravity="center" 
android:id="@+id/myImageView" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
android: layout_weight="19" 
android:paddingTop="Sdip" 
android:paddingBottom-"5dip" 


[^ 
</LinearLayout> 
</HorizontalScroll View > 
</ScrollView> 


<ZoomControls android:id="@+id/zoomcontrol" 


android:layout width-"wrap content" android:layout height-"wrap content" 
android:layout centerHorizontal-"true" 
android:layout_alignParentBottom="true" 
> 
</ZoomControls> 


</RelativeLayout> 
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(2) 
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</FrameLayout> 


] Java 编写 主 程序 代码 ， 代 码 如 下 。 


package com.Johnson.image.zoom; 
import android.app.Activity; 
import android.app.Dialog; 
import android.app.ProgressDialog; 
import android.content.DialogInterface; 
import android.content.DialogInterface.OnK eyListener; 
import android.graphics.Bitmap; 
import android.graphics.BitmapFactory; 
import android.graphics.Matrix; 
import android.os.Bundle; 
import android.os.Handler; 
import android.util.Display Metrics; 
import android.util.Log; 
import android.view.K eyEvent; 
import android.view.MotionEvent; 
import android.view.View; 
import android.view. View.OnClickListener; 
import android.widget.Image View; 
import android.widget.LinearLayout; 
import android.widget.RelativeLayout; 
import android.widget.ZoomControls; 
public class MainActivity extends Activity { 
/** Called when the activity is first created. */ 
private final int LOADING IMAGE = 1; 
public static String KEY IMAGEURI = "ImageUri"; 
private ZoomControls zoom; 
private ImageView mImage View; 
private LinearLayout layoutImage; 
private int display Width; 
private int displayHeight; 
PP E Hr EDS 
private Bitmap bmp; 
/六 宽 的 缩放 比例 */ 
private float scaleWidth = 1; 
PRESTA CECI S 
private float scaleHeight — 1; 
/用 来 计数 放大 +1 缩小 -1%*/ 
private int zoomNumber=0; 
PPHÉ BR MN ABUL, "Ska 


private int showTime=3000; 
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RelativeLayout rl; 
Handler mHandler = new Handler(); 
private Runnable task = new Runnable() { 
public void run() { 
zoom.setVisibility(View.IN VISIBLE); 


@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
//showDialog(LOADING IMAGE); 
/图 片 是 从 网 络 上 获取 的 话 ， 需 要 加 入 滚动 条 
bmp=BitmapFactory.decodeResource(getResources(), R.drawable.image); 
//removeDialog(LOADING IMAGE); 
initZoom(); 


@Override 
protected Dialog onCreateDialog(int id) { 
switch (id) { 
case LOADING IMAGE: { 
final ProgressDialog dialog = new ProgressDialog(this); 
dialog.setOnKeyListener(new OnKeyListener() { 
@Override 
public boolean onKey(DialogInterface dialog, int keyCode, 
KeyEvent event) { 
if (keyCode == KeyEvent. KEYCODE BACK) { 
finish(); 
} 
return false; 
} 
J) 
dialog.setMessage(" 正 在 加 载 图 片 请 稍 后 .…); 


dialog.setIndeterminate(true); 


dialog.setCancelable(true); 
return dialog; 
} 
j 
return null; 
j 
public void initZoom() { 
* 取得 屏幕 分 辨 率 大 小 */ 
DisplayMetrics dm = new DisplayMetrics(); 
getWindowManager().getDefaultDisplay().getMetrics(dm); 
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display Width = dm.widthPixels; 
displayHeight = dm.heightPixels; 
mImage View = (ImageView) findViewById(R.id.myImage View); 
mlmageView.setImageBitmap(bmp); 
layoutImage = (LinearLayout) find ViewByld(R.id.layoutImage); 
mImage View.setOnClickListener(new OnClickListener() { 

@Override 

public void onClick(View v) { 

// TODO Auto-generated method stub 


[** 


* 在 图 片上 和 整个 view 上 同时 添加 单 击 监听 捕捉 
* 单 击 事件 ， 来 显示 放大 缩小 按钮 
* */ 
zoom.set Visibility(View. VISIBLE); 
mHandler.removeCallbacks(task); 
mHandler.postDelayed(task, showTime); 
} 
J) 
layoutImage.setOnClickListener(new OnClickListener() { 
@Override 
public void onClick(View v) { 
// TODO Auto-generated method stub 
zoom.set Visibility(View. VISIBLE); 
mHandler.removeCallbacks(task); 
mHandler.postDelayed(task, showTime); 
} 
J) 


zoom = (ZoomControls) find ViewByld(R.id.zoomcontrol); 


zoom.setIsZoomInEnabled(true); 
zoom.setIsZoomOutEnabled(true); 
/ 图 片 放大 
zoom.setOnZoomInClickListener(new OnClickListener() { 
public void onClick(View v) { 
big0; 
} 
J) 
/ 图 片 减 小 
zoom.setOnZoomOutClickListener(new OnClickListener() { 
public void onClick(View v) { 
small(); 
} 
J) 
zoom.setVisibility(View. VISIBLE); 
mHandler.postDelayed(task, showTime); 
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@Override 
public boolean onTouchEvent(MotionEvent event) { 
// TODO Auto-generated method stub 


[** 


* 在 图 片上 和 整个 view 上 同时 添加 单 击 监听 捕捉 屏幕 
* 单 击 事件 ， 来 显示 放大 缩小 按钮 


EE) 


zoom.setVisibility(View. VISIBLE); 
mHandler.removeCallbacks(task); 
mHandler.postDelayed(task, showTime); 


return false; 


j 


@Override 

public boolean onKeyDown(int keyCode, KeyEvent event) { 
// TODO Auto-generated method stub 
super.onKeyDown(keyCode, event); 


return true; 


j 
^ 图 


片 缩小 的 method */ 


private void small() { 


--zoomNumber; 


int 


int 


bmpWidth = bmp.getWidth(); 
bmpHeight = bmp. getHeight(); 


Log.i("","bmp Width = "+ bmp Width + ", bmpHeight = " + bmpHeight); 


/[* 


j 


设置 图 片 缩小 的 比例 */ 


double scale = 0.8; 


/* 


计算 出 这 次 要 缩小 的 比例 zi 


scaleWidth = (float) (scaleWidth * scale); 
scaleHeight = (float) (scaleHeight * scale); 


/* 


产生 reSize 后 的 Bitmap 对 象 */ 


Matrix matrix = new Matrix(); 
matrix.postScale(scaleWidth, scaleHeight); 
Bitmap resizeBmp = Bitmap.createBitmap(bmp, 0, 0, bmpWidth, bmpHeight, 


matrix, true); 


mlmageView.setImageBitmap(resizeBmp); 


/* 


限制 缩小 尺寸 */ 


if ((scaleWidth * scale * bmpWidth < bmpWidth / 4 


|| scaleHeight * scale * bmpHeight > bmp Width /4 
|| scaleWidth * scale * bmpWidth > display Width / 5 
|| scaleHeight * scale * bmpHeight > display Height / 5)&&(zoomNumber- —-1) ){ 
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zoom.setIsZoomOutEnabled(false); 
} else { 
zoom.setIsZoomOutEnabled(true); 
} 

zoom.setIsZoomInEnabled(true); 


System.gc(); 


} 
/* 图 片 放大 的 method */ 
private void big() { 


++zoomNumber; 

int bmpWidth = bmp.getWidth(); 

int bmpHeight = bmp.getHeight(); 

* 设置 图 片 放 大 的 比例 */ 

double scale = 1.25; 

P 计算 这 次 要 放大 的 比例 */ 
scaleWidth = (float) (ScaleWidth * scale); 
scaleHeight = (float) (scaleHeight * scale); 
上 # 产生 reSize 后 的 Bitmap WA */ 
Matrix matrix = new Matrix(); 
matrix.postScale(scaleWidth, scaleHeight); 


Bitmap resizeBmp = Bitmap.createBitmap(bmp, 0, 0, bmpWidth, bmpHeight, 
matrix, true); 
mlmageView.setImageBitmap(resizeBmp); 
P* 限制 放大 尺寸 */ 
if (scaleWidth * scale * bmpWidth > bmpWidth * 4 
|| scaleHeight * scale * bmpHeight > bmp Width * 4 
|| scaleWidth * scale * bmpWidth > display Width * 5 
|| scaleHeight * scale * bmpHeight > displayHeight * 5) { 
zoom.setIsZoomInEnabled (false); 
} else { 
zoom.setIsZoomInEnabled(true); 


j 


zoom.setIsZoomOutEnabled(true); 


System.gc(); 
} 


14.4.2 ”添加 分 享 到 新 浪 微 博 


在 过 去 浏览 论坛 或 者 博客 的 时 候 ， 每 一 个 论坛 /博客 都 需要 一 个 专用 帐号 ， 但 是 现在 会 发 


现 很 多 网 站 都 有 一 个 “用 新 浪 微 博 登陆 ” “用 QQ 帐号 登录 ”之 类 的 字样 。 这 样 经 过 授权 以 


is 


后 就 可 以 月 


新 浪 或 这 腾讯 的 帐号 登录 到 不 同 论坛 或 者 博客 了 ， 这 确实 是 反方 便 的 事情 ， 可 以 


直接 为 社区 


Android 系统 有 内 置 的 分 享 功 能 , 但 是 内 置 的 分 享 功能 只 有 在 安装 该 应 用 的 时 候 才 会 被 
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示 在 列表 中 ， 下 面 的 是 Android 系统 内 置 的 分 享 功能 ， 如 图 14-3 所 示 。 


授权 云 脉 CC 访问 你 的 微 博 帐号 


St S St 


密码 : 
^ Lu 
| ET 取消 


图 14-3 Android 系统 内 置 的 分 享 功能 


选中 图 14-4 中 的 “分 享 ” 选 项 后 可 以 看 到 “新 浪 微 博 ”， 这 个 是 编者 
列表 的 加 载 代码 如 下 。 


Intent intent = new Intent(Intent.ACTION SEND); 
intent.setType("text/plain"); 
ShareAdapter mAdapter = new ShareAdapter(mContext, intent); 
/对 话 框 的 适配器 
public class ShareAdapter extends BaseAdapter { 
private final static String PACKAGENAME = "com.sina.weibo"; 
private Context mContext; 


private PackageManager mPackageManager; 
private Intent mIntent; 
private LayoutInflater mInflater; 
private List<ResolveInfo> mList; 
private List<DisplayResolveInfo> mDisplayResolvelInfoList; 
public ShareAdapter(Context context, Intent intent) { 
mContext = context; 
mPackageManager = mContext.getPackageManager(); 
mintent = new Intent(intent); 
minflater 
(LayoutInflater)mContext.getSystemService(Context.LAYOUT INFLATER SERVICE); 
mList = mContext.getPackageManager().queryIntentActivities(intent, 
PackageManager. MATCH DEFAULT ONLY); 
/ 排序 
ResolveInfo.DisplayNameComparator comparator 
ResolveInfo.DisplayNameComparator( 
mPackageManager); 
Collections.sort(mList, comparator); 
mbDisplayResolvelnfoList = new ArrayList<DisplayResolveInfo>(); 
if (mList == null || mList.isEmpty()) { 
mList = new ArrayList<Resolvelnfo>(); 
j 


final int N = mList.size(); 


己 添 加 的 。 这 个 


= new 
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for (int i= 0;1i < N; i++) { 
Resolvelnfo ri = mList. get(i); 
CharSequence label = ri.loadLabel(mPackageManager); 
DisplayResolveInfo d= new DisplayResolvelnfo(ri, null, null, label, null); 
mbDisplayResolveInfoList.add(d); 

} 

GREE CBRN, WR BCA D TSI 

if(!isInstallApplication(mContext, PACKAGENAME)) { 
Intent i = new Intent(mContext, ShareActivity.class); 


Drawable d = mContext.getResources().getDrawable(R.drawable.sina); 
CharSequence label = mContext.getString(R.string.about_sina_weibo); 
DisplayResolvelnfo dr = new DisplayResolvelnfo(null, i, null, label, d); 
mDisplayResolveInfoList.add(0, dr); 


} 
@Override 
public int getCount() { 
return mDisplayResolvelInfoList.size(); 
j 
@Override 
public Object getItem(int position) { 
return mDisplayResolvelnfoList.get(position); 
} 
@Override 
public long getItemId(int position) { 
return position; 
j 
@Override 
public View getView(int position, View convertView, ViewGroup parent) { 
View item; 
if(convertView == null) { 
item = mInflater.inflate(R.layout.share_item, null); 
} else { 
item = convertView; 
j 
DisplayResolvelnfo info = mDisplayResolvelnfoList.get(position); 
ImageView i = (Image View) item.findViewById(R.id.share item icon); 
if(info.mDrawable == null) { 
i.setImageDrawable(info.mResoleInfo.loadIcon(mPackageManager)); 
yelse { 
i.setImageDrawable(info.mDrawable); 
j 
TextView t = (TextView) item.findViewById(R.id.share item text); 
t.setText(info.mLabel); 


return item; 
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public ResolveInfo getResolveInfo(int index) { 
if(mDisplayResolvelnfoList == null) { 
return null; 
j 
DisplayResolveInfo d = mDisplayResolvelnfoList.get(index); 
if(d.mResoleInfo == null) { 


return null; 
j 
return d.mResoleInfo; 
j 
/返回 跳 转 intent 


public Intent getIntentForPosition(int index) { 
if(mDisplayResolveInfoList == null) { 
return null; 
j 
DisplayResolveInfo d = mDisplayResolvelInfoList.get(index); 
Intent i = new Intent(d.mIntent == null ? mIntent : d.mIntent); 
i.addFlags(Intent. FLAG ACTIVITY FORWARD RESULT 
Intent.FLAG ACTIVITY PREVIOUS IS TOP); 
if(d.mResoleInfo != null){ 
ActivityInfo a = d.mResoleInfo.activityInfo; 
i.setComponent(new ComponentName(a.applicationInfo.packageName, a.name)); 


} 


return i; 
} 
/检查 是 否 安装 该 app 
boolean isInstallApplication(Context context, String packageName) { 
try { 
mPackageManager 
-getApplicationInfo(packageName, 
PackageManager.GET UNINSTALLED PACKAGES); 
return true; 
} catch (NameNotFoundException e) { 
return false; 


= 一 


* 打包 数据 vo 

* @author Administrator 

St 

class DisplayResolveInfo { 

private Intent mIntent; 
private ResolveInfo mResoleInfo; 
private CharSequence mLabel; 
private Drawable mDrawable; 
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DisplayResolveInfo(ResolveInfo resolveInfo, Intent intent, 
CharSequence info, CharSequence label, Drawable d) { 
this.mIntent = intent; 
this.mResoleInfo = resolvelnfo; 
this.mLabel = label; 
this. mDrawable = d; 


j 


以 上 就 加 载 了 弹出 框 的 数据 适配器 ， 如 果 系 统 已 经 安装 则 直接 读 取 系统 的 分 享 ， 没 有 则 
添加 。 当 单 击 分 享 微 博 的 时 候 需 要 一 系列 的 验证 和 授权 ， 此 处 采用 的 机 制 是 先 获取 
requestToken， 然 后 通过 requestToken 获取 AccessToken， 然 后 才 可 以 分 享 微 博 。 

接 下 来 在 单 击 “ 分 享 到 微 博 ”的 时 候 进行 用 户 认证 ， 这 里 的 认证 是 读 取 新 浪 提供 的 页 面 ， 
下 面 是 部 分 代码 。 


Weibo weibo = new Weibo(); 

RequestToken requestToken = weibo.getO AuthRequestToken("yunmai://ShareA ctivity"); 
Log.i(TAG, "token:" + requestToken.getToken() + ",tokenSecret:" + requestToken.getTokenSecret()); 
OAuthConstant.getInstance().setRequestToken(requestToken); 

Uri uri = Uri.parse(requestToken.getAuthenticationURL() + "&display=mobile"); 

url = uri.toString(); 


ò 


上 面 的 地 址 url 就 是 请 求 新 浪 时 提供 的 登录 界面 的 地 址 了 ， 此 时 会 涉及 到 WebView 的 使 
J. 在 Android 里 面 WebView 其 实 就 是 一 个 小 型 浏览 器 ， 功 能 很 强大 ， 强 大 到 可 以 执行 脚本 。 
有 了 地 址 即 可 以 通过 webview.loadurl(urD) 请 求 登录 界面 。 也 许 读 者 可 能 会 想 自 己 设 计 一 个 登录 
界面 ， 但 是 新 浪 官 方 说 明 : 通过 getXauthAccessToken 方式 认证 可 以 自行 设计 登录 界面 ， 其 他 
认证 方式 是 不 能 够 自行 设计 的 。 单 击 “ 授 权 ” 按 钮 时 需要 跳 转 到 自己 的 Activity 中 ， 此 处 的 配 


置 是 需要 在 androidmanifest.xml 中 配置 的 ， 例 如 设置 跳 转 到 shareactivity.java. 


<activity 


android:name="cn.yunmai.cclauncher.ShareActivity" 
android:screenOrientation="portrait" > 
<intent-filter> 
«action android:name="android. intent.action. VIEW" /> 
«category android:name-"android.intent.category. DEFAULT" /> 
«category android:name="android.intent.category.BROWSABLE" /> 
«data android:host="ShareActivity" android:scheme="yunmai" /> 
</intent-filter> 
</activity> 


在 此 需要 注意 的 是 ， 在 <data> 标 签 中 的 内 容 需要 和 显示 授权 窗 的 weibo.get 
OAuthRequestToken("yunmai://ShareActivity") 相 对 应 。 当 授权 完成 之 后 就 会 跳 转 到 自己 定义 的 
Activity， 授 权 完 成 之 后 就 会 将 微 博 发 送 到 跳 转 之 后 的 Activity。 在 单 击 发 送 按钮 的 时 ， 先 获 
取 刚 才 授权 成 功 的 RequestToken， 然 后 再 获取 accessToken， 最 后 发 送 微 博 。 在 此 需要 注意 的 
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是 ，RequestToken 只 需 获 取 一 次 即 可 ， 获 取 的 口令 被 保存 为 accessToken， 以 后 使 用 时 只 需 直 
接 调用 accessToken。 单 击发 送 按钮 的 操作 代码 如 下 。 

Uri uri = this.getIntent().getData(); 

RequestToken requestToken = OAuthConstant. getInstance().getRequestToken(); 


AccessToken accessToken = requestToken.getAccessToken(uri.getQueryParameter("oauth_verifier")); 
saveAccessToken(accessToken);//{x. £f. accessToken 
Log.i(TAG, "oauth_verifier:" + uri.getQueryParameter("oauth_verifier") + 
"Token" + accessToken.getToken() + ",TokenSecret:" + accessToken. 
getTokenSecret()); 
OAuthConstant.getInstance().setAccess Token(accessToken); 


下 面 代 码 所 执行 的 操作 是 获取 授权 之 后 的 accessToken， 然 后 发 送 微 博 。 


Weibo weibo = OAuthConstant.getInstance().getWeibo(); 
weibo.setToken(OAuthConstant.getInstance().getToken(), OAuthConstant.getInstance().getT okenSecret()); 
Status s = weibo.updateStatus(mEdit.getText().toString()); 


H 


Status 返 


了 一 些 详细 的 信息 ， 有 发 送 时 间 和 用 户 ID 等 ， 这 就 样 就 完成 了 分 享 功能 。 


14.4.3 ”通过 SON 对 象 获取 登录 新 浪 微 博 

可 以 引用 新 浪 开发 包 中 的 各 种 类 ， 在 Android 中 通过 ISON 对 象 的 方式 登录 新 浪 微 博 。 
在 下 面 的 代码 中 ，1 代表 登陆 成 功 ，0 代表 登陆 失败 。 并 通过 verifyCredentials0) 方 法 请 求 新 浪 
微 博 服 务 器 返回 ISON 对 象 。 


i 


ri 


package com.sfc.ui; 

import java.util. ArrayList; 

import java.util List; 

import com.sfc.ui.adapter.LoginListA dapter; 


import weibo4j.User; // 这 是 新 浪 开发 包 中 的 实体 类 
import weibo4j. Weibo; // 这 是 新 浪 开发 包 中 的 类 
import weibo4j. WeiboException; // 这 是 新 浪 开发 包 中 的 类 


import android.app.Activity; 
import android.app.AlertDialog; 
import android.app.ProgressDialog; 
import android.os.Bundle; 
import android.os.Handler; 
import android.os.Message; 
import android.util.Log; 
import android.view. View; 
import android.view. View.OnClickListener; 
import android.widget.Button; 
import android.widget.ListView; 
import android.widget.Toast; 
public class LoginActivity extends Activity implements Runnable { 
private Button loginButton; 
private ListView list View; 
private ProgressDialog loginDialog; 
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private Thread loginThread; 

private Handler handler; 

@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.login); 
loginButton = (Button) findViewByld(R.id.loginButton); 
List<String> list = new ArrayList<String>(); 
list.add(" 随 便 看 看 "); 
list.add(" 推 荐 用 户 "); 
list.add(" 热 门 转发 "); 
list View = (ListView)findViewById(R.id.listView); 
loginThread = new Thread(this); 


handler = new Handler(){ 
/1 代表 登陆 成 功 0 代表 登陆 失败 
public void handleMessage(Message msg) { 
loginDialog.cancel(); 
switch (msg.what) { 
case 1: 
Toast.makeText(LoginActivity.this, "登陆 成 功 ", 3000).show(); 
break; 
case 0: 
Toast.makeText(LoginActivity.this, "登陆 失败 ", 3000).show(); 
break; 
} 
h 
h 
listView.setAdapter(new LoginListA dapter(this, list)); 
loginButton.setOnClickListener(new OnClickListener() ( 
public void onClick(View v) ( 
loginDialog = new ProgressDialog(LoginA ctivity.this); 
loginDialog.setProgressStyle(ProgressDialog.STYLE SPINNER); 
loginDialog.setMessage(" X5 bi Hk at"); 
loginDialog.show(); 
loginThread.start(); 


j 
Dk 
} 
public void run() { 
Log.e("loginThread","start"); 
Weibo weibo = new Weibo("XXX@sina.com","X XX"); /新 浪 微 博 用 户 名 和 密码 
weibo.setHttpConnectionTimeout(5000); 


Message msa = new Message(); 

try { 
User user = weibo.verifyCredentials(); /该 方法 会 请 求 新 浪 微 博 服 务 器 返回 ISON AS 
msa.what=1; 

} catch (WeiboException e) { 
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msa.what=0; 
} 
} 
} 


14.4.4 实现 OAuth 认证 


OAuth 协议 为 用 户 资源 的 授权 提供 了 一 个 安全 的 、 开 放 而 又 简易 的 标准 。 与 以 往 的 授权 
方式 不 同 ，OAuth 授权 不 会 使 第 三 方 触 及 用 户 的 帐号 信息 (如 用 户 名 与 密码 )， 即 第 三 方 无 需 
使 用 用 户 的 用 户 名 与 密码 就 可 以 申请 获得 该 用 户 资 源 的 授权 ， 因 此 OAuth 是 安全 的 。 

新 浪 微 博 为 了 实现 自身 的 安全 性 ， 采 用 了 Oauth 协议 认证 方式 。 虽然 下 面 的 一 段 代 码 比 
较 人 简单， 但 是 实现 了 新 浪 微 博 的 OAuth 认证 。 


System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
Weibo weibo = new Weibo(); 
// 根 据 App Key 第 三 方 应 用 向 新 浪 获 取 requestToken 
RequestToken requestToken = weibo.getOAuthRequestToken(); 
System.out.printIn("1.......Got request token 成 功 "); 
System. out.println(""Request token: "+ requestToken. getToken()); 
System.out.println(""Request token secret: "+ requestToken.getTokenSecret()); 
AccessToken accessToken = null; 
1/ 用 户 从 新 浪 获 取 verifier code 如果 是 Android 或 iOS 应 用 可 以 callback =json&userld= 
xxs&password-XXX 
System.out.printIn("Open the following URL and grant access to your account:"); 
System.out.printIn(requestToken.getAuthorizationURL()); 
BareBonesBrowserLaunch.openURL(requestToken.getAuthorizationU RL()); 

/用 户 输入 验证 码 授权 信任 第 三 方 应 用 
BufferedReader br = new BufferedReader(new InputStreamReader(System.in)); 
while (null == accessToken) { 

System.out.print("Hit enter when it's done.[Enter]:"); 
String pin = br.readLine(); 
System.out.println("pin: " + br.toString()); 
try{ 
// 通 过 传递 requestToken 和 用 户 验证 码 获 取 AccessToken 
accessToken = requestToken.getAccessToken(pin); 
} catch (WeiboException te) { 
if(401 == te.getStatusCode()) { 
System.out.printIn("Unable to get the access token."); 
else 
te.printStackTrace(); 


} 


} 

System.out.println("Got access token."); 

System.out.printIn(" Access token: "+ accessToken.getToken()); 
System.out.println(" Access token secret: "+ accessToken.getTokenSecret()); 
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文人 


// 使 用 AccessToken 来 操作 用 户 的 所 有 接口 
/* Weibo weibo=new Weibo(); 
以 后 就 可 以 用 下 面 accessToken 访问 用 户 的 资料 了 
* weibo.setToken(accessToken.getToken(), accessToken.getTokenSecret()); 
/发 布 微 博 
Status status = weibo.updateStatus("test message6 "); 
System.out.println(" Successfully updated the status to [" 
+ status.getText() + "]."); 
try { 
Thread.sleep(3000); 
} catch (InterruptedException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
y" 
System.exit(0); 
} catch (WeiboException te) { 
System.out.println("Failed to get timeline: " + te.getMessage()); 
System.exit( -1); 
} catch (IOException ioe) { 
System.out.printIn("Failed to read the system input."); 
System.exit( -1); 


j 


FOAuthActivity.java 实现 了 得 到 OAuth 后 的 提示 处 理 , 验证 成 功 后 会 得 到 AccessToken 


的 key 和 Secret， 可 以 使 用 这 两 个 参数 进行 授权 登录 。 文 件 OAuthActivity.java 的 具体 实现 代 


人 码 如 下 。 
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public class OAuthActivity extends Activity { 


public void onCreate(Bundle savedInstanceState) { 

super.onCreate(savedInstanceState); 

setContentView(R.layout.timeline); 

Uri uri=this.getIntent().getData(); 

try { 
RequestToken requestToken= OAuthConstant.getInstance().getRequestToken(); 
AccessToken accessToken-requestToken.getAccessToken(uri.getQueryParameter 

("oauth_verifier")); 

OAuthConstant.getInstance().setAccessToken(accessToken); 
TextView textView = (TextView) findViewByld(R.id.TextView01); 
textView.setText(" 得 到 AccessToken DÉI key 和 Secret, 可 以 使 用 这 两 个 参数 进行 授权 
登录 了 .mn Access token:\n"+accessToken.getToken()+"\n Access token secret:\n"+ 
accessToken.getTokenSecret()); 

} catch (WeiboException e) { 
e.printStackTrace(); 


} 

Button button= (Button) findViewByld(R.id.Button01); 
button.setText(" 某 一 话题 下 的 微 博 "); 
button.setOnClickListener(new Button.OnClickListener() 
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public void onClick( View v ) 
1 
Weibo weibo-OAuthConstant.getInstance().get Weibo(); 
weibo.setToken(OAuthConstant.getInstance().getToken(), 
OAuthConstant.getInstance().get T okenSecret()); 
List<Status> friendsTimeline; 
try { 
friendsTimeline = weibo.get l'rendStatus("seaeast", new Paging(1,20)); 
StringBuilder stringBuilder = new StringBuilder(" 1"); 
for (Status status : friendsTimeline) { 
stringBuilder.append(status.getUser().getScreenName() + "说 :" 
+ status.getText() + "------------------------- \n"); 
} 
TextView textView = (TextView) findViewByld(R.id.TextView01); 
text View.setText(stringBuilder.toString()); 
} catch (WeiboException e) { 
e.printStackTrace(); 


DE 


这 样 在 执行 后 会 显示 一 个 触发 OAuth 认证 的 按钮 , 如 图 14-4 所 示 。 单 击 GoGo 按钮 后 会 
得 到 OAuth 认证 后 的 key 和 Secret, "lll 14-5 所 示 。 


AMA 5:14 om AMA 5:22 eu 
welbodandrold 


图 14-4 触发 按钮 图 14-5 得 到 key 和 Secret 


14.45 ”获取 用 户 信 息 
通过 文件 GetFollowers.java 可 以 返回 用 户 关注 对 象 列 表 ， 并 返回 最 新 微 博文 章 。 文 件 


T 


T 
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GetFollowers.java 的 具体 实现 代码 如 下 。 


public static void main(String[] args) { 

System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 

Weibo weibo = new Weibo(); 

weibo.setToken(args[0],args[1]); 

List<User> list = weibo.getFollowersStatuses(); 

for(User user : list) { 

System.out.printIn(user.toString()); 

} 
} catch (WeiboException e) { 

e.printStackTrace(); 


j 
通过 文件 GetFriends.java 获取 当前 用 户 的 朋友 信息 ， 有 具体 实现 代码 如 下 。 


public static void main(String[] args) { 
try { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo. CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo. CONSUMER SECRET); 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0], args[1]); 
try { 
List<User> list= weibo.getFriendsStatuses(); 
System.out.printIn("Successfully get Friends to [" + list + "]."); 
} catch (Exception e1) { 
// TODO Auto-generated catch block 
el .printStackTrace(); 
} 
System.exit(0); 
} catch (Exception ioe) { 
System.out.printIn("Failed to read the system input."); 
System.exit( -1); 


} 


通过 文件 GetUserInfo.java 获取 当前 登录 用 户 的 基本 信息 ， 有 具体 实现 代码 如 下 。 


public class GetUserInfo { 


[** 
* 根据 用 户 ID 获取 用 户 资料 〈 授 权 用 户 ) 


* @param args 
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* @throws UnsupportedEncodingException 
Zb 
public static void main(String[] args) throws UnsupportedEncodingException { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 


try { 


String screen name=" 李 开 复 "; 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
User user = weibo.showUser(screen name); 
System.out.printIn(user.toString()); 

} catch (WeiboException e) { 
e.printStackTrace(); 


14.46 关注 用 户 
通过 文件 ShowFriendships.java 显示 当前 ID 用 户 和 某 个 用 户 的 关系 ,具体 实现 代码 如 下 。 


public class ShowFriendships { 
[** 
* 返回 两 个 用 户 关 系 的 详细 情况 
* @param args 
Se? 
public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo. CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo. CONSUMER SECRET); 


try { 


/自己 与 该 关注 对 象 的 关系 

Weibo weibo = new Weibo(); 

weibo.setToken(args[0],args[1]); 

JSONObject object = weibo.showFriendships(args[2]);//args[2]: 11: H P DÉI id 

JSONObject source = object.getJSONObject("source"); 

JSONObject target = object.getJSONObject("target"); 
System.out.printIn(source.getString("screen name")*-" 5j"-target.getString("screen - 
name")+" 互 为 关注 "); 

/两 个 用 户 关系 的 详细 情况 

object= weibo.showFriendships(args[3 ],args[4]); 


source = object. getJSONObject("source"); 
target = object.getJSONObject("target"); 
System.out println(source.getString("screen_name")+"-5)"+target getString("screen_name")+" 4. 
为 关注 "); 
} catch (Exception e) { 


e.printStackTrace(); 
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} 


通过 文件 ExistsFriendship.java 提醒 当前 ID 用 户 是 否 关 注 这 个 用 户 ， 具 体 实现 代码 


public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo. CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 
/largs[2]: Él AY id; args[3]: 关 注 对 象 的 id 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
boolean bool = weibo.existsFriendship(args[2],args[3]);//args[2]: 2&1 HA K id 
System.out.printIn(bool); 
} catch (WeiboException e) { 
e.printStackTrace(); 


} 


通过 文件 CreateFriendship.java 实现 关注 某 一 个 用 户 的 功能 ， 有 具体 实现 代码 如 下 。 


public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
User user = weibo.createFriendship(args[2]);//args[2]: 211: H] É% id 
System.out.printIn(user.toString()); 
} catch (WeiboException e) { 
e.printStackTrace(); 


j 


通过 文件 DestroyFriendship java 取消 关注 某 一 个 用 户 ， 具 体 实 现代 码 如 下 。 


public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo. CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
User user = weibo.destroyFriendship(args[2]);//args[2]:2«13:H] ^ ff] id 
System.out.printIn(user.toString()); 
} catch (WeiboException e) { 
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e.printStackTrace(); 


14.4.7 实现 收藏 功能 


通过 文件 GetFavorites.java 获取 当前 ID 用 户 的 收藏 列表 ， 有 具体 实现 代码 如 下 。 


public static void main(String[] args) { 

System.setProperty("weibo4j.oauth.consumerKey", Weibo. CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 

Weibo weibo = new Weibo(); 

weibo.setToken(args[0],args[1]); 

List<Status> list = weibo.getFavorites(); 

for(Status status : list) { 

System.out.println(status.toString()); 

} 
} catch (WeiboException e) { 

e.printStackTrace(); 


j 


通过 文件 CreateFavorite java 实现 添加 收藏 功能 ， 具 体 实现 代码 如 下 。 


public class CreateFavorite { 
[** 
* 添加 收藏 
* @param args 
ea 
public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo. CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo. CONSUMER SECRET); 
try { 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
Status status = weibo.createFavorite(Long.parseLong(args[2])); 
System.out.println(status.toString()); 
} catch (WeiboException e) { 
e.printStackTrace(); 


j 


通过 文件 DestroyFavorite.java 实现 取消 收藏 功能 ， 有 具体 实现 代码 如 下 。 
public class DestroyFavorite { 
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[** 
* 删除 当前 用 户 收藏 的 微 博信 息 
* @param args 
*/ 
public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo. CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo. CONSUMER SECRET); 
try { 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 


weibo.destroyFavorite(Long.parseLong(args[2])); 

List<Status> list = weibo.getFavorites(); 

for(Status status : list) { 
System.out.println(status.toString()); 


} 
} catch (WeiboException e) { 
e.printStackTrace(); 


14.4.8 ”实现 微 博 操作 功能 
通过 文件 DeleteComment.java 删除 已 经 发 布 的 某 条 评论 ， 有 具体 实现 代码 如 下 。 


public class DeleteComment { 
[** 
* 删除 评论 ， 
* @param args 
«n 
public static void main(String[] args) 1 
System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
Status status = weibo.updateStatus("test4us"); 
Thread.sleep(1000); 
String sid = status. getId) +""; 
System.out.println(sid + " : "+ status.getText()*" "+status.getCreatedAt()); 


Comment comment = weibo.updateComment("comment4u", sid, null); 


jul 


能 删除 自己 发 布 的 评论 


System.out.println(comment.getId0 + " : "+ comment.getText() +" "+ comment. 
getCreatedAt()); 
Thread.sleep(1000); 
weibo.destroyComment(comment.getId()); 
} catch (Exception e) { 
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e.printStackTrace(); 


j 


通过 文件 DeleteStatus.java 删除 某 一 条 微 博信 息 ， 有 具体 实现 代码 如 下 。 


public class DeleteStatus { 
[** 
* 删除 一 条 微 博信 息 
* @param args 
SH 
public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo. CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
// 先 发 表 一 篇 微 博 
Status status = weibo.updateStatus(" 测 试 测试 "); 
System.out.println(status.getId() + " : "+ status.getText()+" "+status.getCreatedAt()); 
/删除 刚 发 表 的 微 博 
status = weibo.destroyStatus(status.getId()); 
List<Status> list = weibo.getUserTimeline(args[2]);//args[2]: H] D id 
for(Status st ` list) {// 遍 历 当 前 微 博 信息 
System.out.println(st.getId() +": "+ st.getText()+" "+st.getCreatedAt()); 


} 
} catch (Exception e) { 
e.printStackTrace(); 


j 


通过 文件 ForwardStatus.java 根据 微 博 ID 和 用 户 ID 跳 转 到 单条 微 博 页 面 ， 具体 实 现代 码 
如 下 。 


public class ForwardStatus { 
public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
List<Status> list = weibo.getUserTimeline(); 
if(list.size() > 0) { 
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//args[2]: 用 户 的 id 
String url = "http://api.t.sina.com.cn/"+args[2]+"/statuses/"+list.get(0).getId(); 
// 打 开 单 条 微 博信 息 页 面 


Runtime.getRuntime().exec("cmd /c start "+url); 


} 

} catch (Exception e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


j 


请 过 


通过 文件 GetRepostTimeline.java 返回 一 条 原创 微 博 消息 的 最 新 n 条 转发 微 博 消息 ， 但 是 
本 接口 无 法 对 非 原创 微 博 进行 查询 。 具 体 实现 代码 如 下 。 


D 


public class GetRepostTimeline { 
public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo. CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
List «Status» list —- ^ weibo.getreposttimeline(args[2 ]); 
for(Status status:list) 
System.out.println(status.toString()); 
} 
} catch (Exception e) { 
e.printStackTrace(); 


j 


通过 文件 GetStatus.java 获取 单条 ID 的 微 博 信息 ， 并 同时 返回 作者 信息 。 有 具体 实现 代码 


public class GetStatus { 
[** 
* 获取 单条 ID 的 微 博信 息 ， 作 者 信息 将 同时 返回 
* @param args 
say 
public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo. CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo. CONSUMER SECRET); 
try { 


Weibo weibo = new Weibo(); 
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weibo.setToken(args[0],args[1]); 

List<Status> list = weibo.getUserTimeline(args[2 ], new Paging(1).count(4)); 

if(list.size() > 0) { 
Status status = weibo.showStatus(list.get(0).getId()); 
System.out.println( status.getId() +" :'"+status.getText()); 

} 

} catch (Exception e) { 
e.printStackTrace(); 


j 


通过 文件 Reply.java 对 一 条 微 博 评论 信息 进行 回复 ， 具 体 实现 代码 如 下 。 


public class Reply { 
public static void main(String[| args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
List<Status> list = weibo. getUserTimeline(args[2]); 
if(list.size() > 0) { 
/最 新 一 条 微 博信 息 ID 
String sid = list.get(0).getId()-""; 


List<Comment> comments = weibo.getComments(sid); 


if(comments.size() > 0) { 
String cid = comments.get(0).getIdO+"";// 评 论 的 id 


Comment status = weibo.reply(sid, cid, "回复 内 容 ");//args[3]: 
System.out.println(status.toString()); 


RH 
2 
"2 


} 
} catch (Exception e) { 
e.printStackTrace(); 


j 


通过 文件 Repost.java 转发 一 条 微 博 信息 ， 具 体 实现 代码 如 下 。 
public class Repost { 
public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 
Weibo weibo = new Weibo(); 
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weibo.setToken(args[0],args[1]); 
String sid = "11814288270"; 
Thread.sleep(1000); 
/args[2]: 添加 转发 的 信息 
Status status = weibo.repost(sid, args[2]); 


System.out.printIn(status.toString()); 
} catch (Exception e) { 
e.printStackTrace(); 


j 


通过 文件 RepostByMe.java 获取 用 户 最 新 转发 的 n 条 微 博 消息 ， 具 体 实 现代 码 如 下 。 


public class RepostByMe { 
public static void main(String[] args) { 
System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
List «Status» list — weibo.getrepostbyme(args[2]); 
for(Status status:list) { 
System.out.println(status.toString()); 
} 
} catch (Exception e) { 
e.printStackTrace(); 


j 


通过 文件 UpdateComment.java 对 一 条 微 博信 息 进 行 评 论 ， 有 具体 实现 代码 如 下 。 


public class UpdateComment { 
public static void main(String[] args) { 

System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 
System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 
try { 

Weibo weibo = new Weibo(); 

weibo.setToken(args[0],args[1]); 

Status status — weibo.updateStatus("test....."); 

Thread.sleep(1000); 

String sid = status. geld VT: 

Comment comment = weibo.updateComment("1", sid, null); 


System.out.println(comment.getId() + " : "+ comment.getText() +" "+ 
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comment.getCreatedAt()); 

Thread.sleep(1000); 

comment = weibo.updateComment("2", sid, null); 
System.out.printlIn(comment.getId() + " : "+ comment.getText()+" "+ 
comment.getCreatedAt()); 

Thread.sleep(1000); 

comment = weibo.updateComment("3", sid, null); 
System.out.printlIn(comment.getId() + " : " + comment.getText() +" "+ 
comment.getCreatedAt()); 

Thread.sleep(1000); 

comment = weibo.updateComment("4", sid, null); 
System.out.printIn(comment.getId()  " : " + comment.getText() +" "+ 
comment.getCreatedAt()); 

Thread.sleep(1000); 

comment = weibo.updateComment("5", sid, null); 
System.out.printIn(comment.getId() + " : " + comment.getText() +" "+ 
comment.getCreatedAt()); 

Thread.sleep(1000); 

comment = weibo.updateComment("6", sid, null); 
System.out.printlIn(comment.getId() + " : "+ comment.getText()+" "+ 
comment.getCreatedAt()); 


} catch (Exception e) { 
e.printStackTrace(); 


j 
通过 文件 UpdateStatus.java 发 布 一 条 新 的 微 博 信息 ， 有 具体 实现 代码 如 下 。 


public class UpdateStatus { 
public static void main(String[] args) { 

System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER KEY); 

System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER SECRET); 

try { 
Weibo weibo = new Weibo(); 
weibo.setToken(args[0],args[1]); 
Status status = weibo.updateStatus(" AX Y T, ATES. "); 
System.out.printIn(status.getId() + " : "+ status.getText()+" "+status.getCreatedAt()); 


} catch (Exception e) { 
e.printStackTrace(); 


EN 437 


"8155 开发 Web 版 的 电话 本 管理 系统 


经 过 本 书 前 面 内 容 的 学 习 , 已 经 掌握 了 HTMLS. jQuery Mobile 和 PhoneGap 的 基本 知识 。 
在 本 章 的 内 容 中 ， 将 综合 运用 本 书 前 面 所 学 的 知识 ， 并 结合 使 用 CSS 和 JavaScript 的 技术 ， 
发 一 个 在 Android 平台 运行 的 电话 本 管理 系统 。 


15.1 需求 分 析 


本 实例 使 用 “HTML 5+jQuery Mobilet+PhoneGap” 技 术 实 现 一 个 经 典 的 电话 本 管理 工具 ， 
实现 对 设备 内 联系 人 信息 的 管理 ， 包 括 添 加 新 信息 、 删 除 信息 、 快 速 搜索 信息 、 修 改 信息 、 
更 新 信息 等 功能 。 在 本 节 的 内 容 中 ， 将 对 本 项 目 进 行 必要 的 需求 性 分 析 。 

15.11 产生 背景 

随 着 网 络 与 信息 技术 的 发 展 ， 很 多 卫生 人 之 间 也 都 有 了 或 多 或 少 的 联系 。 如 何 更 好 地 管 
里 这 些 信息 是 每 个 人 必须 面临 的 问题 ， 特 别 是 那些 很 久 没 有 联系 的 朋友 ， 再 次 见面 无 法 马上 
回忆 关于 这 个 人 的 信息 ， 造 成 了 一 些 不 必要 的 尴 挫 。 基 于 上 述 种 种 原因 ， 开 发 一 套 通 讯 录 管 
里 系统 很 重要 。 
另外 ， 随 着 移动 设备 平台 的 发 展 ， 以 Android 为 代表 的 智能 手机 系统 已 经 普及 到 普通 消 
费 者 。 智 能 手机 设备 已 经 成 为 了 人 们 生活 中 必 不 可 少 的 物品 。 在 这 种 历史 背景 之 下 ， 手 机 通 
讯 录 变 得 愈 发 重要 ， 已 经 成 为 人 们 离 不 开 的 联系 人 系统 。 

本 系统 的 主要 目的 是 为 了 更 好 的 管理 每 个 人 的 通讯 录 ， 给 每 个 人 提供 一 个 井然 有 序 的 
时 平台 ， 防 止 手工 管理 混乱 而 造成 的 不 必要 麻烦 。 


15.1.2 ”功能 分 析 


通过 市 场 调 查 可 知 ， 一 个 完整 的 电话 本 管理 系统 应 该 包括 : 添加 模块 、 主 窗 体 模块 、 信 
娠 查询 模块 、 信 息 修改 模块 、 系 统管 理 模块 。 本 系统 主要 实现 设备 内 联系 人 信息 的 管理 ， 包 
括 添加 、 修 改 、 查 询 和 删除 。 整 个 系统 模块 划分 如 图 15-1 所 示 。 
(1) 系统 管理 模块 
用 户 通 过 此 模块 来 管理 设备 内 的 联系 人 信息 ， 在 屏幕 下 方 提供 了 实现 系统 管理 的 5 
个 按钮 。 
O 搜索 ， 单 击 此 按钮 后 能 够 快速 搜索 设备 内 需要 搜索 的 联系 人 信息 。 
口 添加 : 单 击 此 按钮 后 能 够 向 设备 内 添加 新 的 联系 人 信息 。 
O 修改 : 单 击 此 按钮 后 能 够 修改 设备 内 已 经 存在 的 某 条 联系 人 信息 。 
O 删除 : 单 击 此 按钮 后 删除 设备 内 已 经 存在 的 某 条 联系 人 信息 。 
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O 更 新 : 单 击 此 按钮 后 能 够 更 新 设备 的 所 有 联系 人 信息 。 


电话 本 
管理 系统 


(2) 系统 主 界面 


图 15-1 系统 构成 模块 图 


在 系统 主屏 幕 界面 中 显示 了 两 个 操作 按钮 ， 通 过 这 两 个 按钮 可 以 快速 进入 本 系统 的 核心 


功能 
口 查询 : 单 击 此 按钮 后 能 够 来 到 系统 搜索 界面 ， 能 够 快速 搜索 设备 内 我 们 需要 的 联系 人 
Hi ds 


O TUS 单 击 此 按钮 后 能 够 来 到 系统 管理 模块 的 主 界面 。 
(3) 信息 添加 模块 
过 此 模块 能 够 向 设备 中 添加 新 的 联系 人 信息 。 
) 信息 修改 模块 
过 此 模块 能 够 修改 设备 内 已 经 存在 的 联系 人 信息 。 
9 息 删除 模块 

过 此 模块 能 够 删除 设备 内 已 经 存在 的 联系 人 信息 。 
言 息 查询 模块 
通过 此 模块 能 够 搜索 设备 内 需要 查询 的 联系 人 信息 。 


SES 


n CA 
[o 
nil; 


Aa P 
d 
Mil 
TI 
> 


15.2 ”创建 Android 工程 


(1) 启动 Eclipse， 依 次 选中 File>New— Other 选项 ， 然 后 在 树 形 结构 中 找到 Android 15 


点 。 并 单 击 Android Project， 在 项 目 名 称 栏 中 输入 phonebook。 


(2) 单 击 Next 按钮 ， 选 择 目标 SDK， 在 此 选择 43. Ald 
com.example.web dhb， 如 网 15-2 所 示 。 


F Next 按钮 ， 在 其 ! 


填写 包 名 
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Application Name: afphonebook 
Project Name: 6 [phonebock 
Package Name: t [eon. example.web dhb| 


Minimum Required SDK:O[API 8: Android 2.2 (Froyo) č č v] 
Target SDK:G[|API 17: Android 4.2 CellyBean) v] 

Compile With:O[AFI 18: Àniroid4 3 v] N 
Thene: G[Holo Light with Dark Action Bar = Y] 


图 15-2 创建 Android 工程 


(3) 单 击 Next 按钮 ， 此 时 将 成 功 构建 一 个 标准 的 Android 项 目 。 图 15-3 展示 了 当前 项 
目的 目录 结构 。 


I$ Package Explorer 23 — m 
gig 了 


SS phonebook 


£8 com. example. web_dhb 
十 D MainActivity. java 
人 gen [Generated Java Files] 
BA Android 4.3 
MA Android Private Libraries 
ae assets 
E» bin 
E» libs 
出 res 

17 Ander oi dan) fest. xml 

Be ic_launcher-web. png 
proguard-project. txt 
project. properties 


3... D.D. E] E] 


图 15-3 创建 的 Android 工程 


(4) 修改 文件 MainActivityjava， 为 此 文件 添加 执行 HTML 文件 的 代码 ， 主 要 代码 如 下 。 


public class MainActivity extends DroidGap { 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
super.loadUrl("file:///android asset/www/main.html"); 


15.3 ”实现 系统 主 界面 


在 本 实例 中 ， 系 统 主 界面 的 实现 文件 是 main.html， 主 要 实现 代码 如 下 。 
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<script srec="./js/jquery.js"></script> 
<script src="./js/jquery.mobile-1.2.0.js"></script> 
<script src="./cordova-2.1.0.js"></script> 


</head> 
<body> 
<!-- Home --> 
<div data-role="page" id="page1" style="background-image: url(./img/bg.gif);" > 
<div data-theme="e" data-role="header"> 
<h2> 电 话 本 管理 中 心 </h2> 
</div> 
<div data-role="content" style="padding-top:200px;"> 
<a data-role="button" data-theme="e" href="./select.html" id="chaxun" data-icon= 


"search" data-iconpos="left" data-transition="flip"> 查 询 </a> 
<a data-role-"button" data-theme="e" href="./set.html" id="guanli" data-icon= 
"gear" data-iconpos="left"> 管理 </a> 
</div> 
<div data-theme="e" data-role="footer" data-position="fixed"> 
<span class="ui-title" > 9*2] 2A Hill fE v1.0«/span 
</div> 


<script type="text/javascript"> 


sessionStorage.setItem("uid",""); 
$(‘#page 1').bind(‘pageshow’,function() { 
$.mobile.page.prototype.options.domCache = false; 
D 
/ 等 待 加 载 PhoneGap 
document.addEventListener("deviceready", onDeviceReady, false); 
// PhoneGap 加 载 完毕 
function onDeviceReady() { 
var db = window.openDatabase("Database", "1.0", "PhoneGap myuser", 200000); 
db.transaction(populateDB, errorCB); 
j 
/ 填充 数据 库 
function populateDB(tx) { 
tx.executeSql((CREATE TABLE IF NOT EXISTS ‘myuser (user id 
integer primary key autoincrement , user name VARCHAR( 25 ) NOT NULL "user phone varchar( 15 ) NOT 
NULL , user qq varchar( 15 ) , user email VARCHAR 50 ), user bz TEXT); 


} 
/ 事务 执行 出 错 后 调用 的 回调 函数 
function errorCB(tx, err) { 

alert("Error processing SQL: "*+err); 


} 
</script> 
</div> 
</body> 
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</html> 


执行 后 的 效果 如 图 15-4 所 示 。 


图 15-4 执行 效果 


15.4 ”实现 信息 查询 模块 


信息 查询 模块 的 功能 是 快速 搜索 设备 内 需要 查询 的 联系 人 信息 。 单 击 图 15-3 中 的 “查询 ” 
按钮 后 会 跳 转 到 查询 界面 ， 如 图 15-5 所 示 。 


姓名 电话 拨号 
aaa 13000000000 挨 打 
图 15-5 查询 界面 


在 查询 界面 上 面 的 表单 中 可 以 输入 搜索 关键 字 ， 然 后 单 击 “查询 ”按钮 后 会 在 下 方 显示 
搜索 结果 。 信 息 查 询 模块 的 实现 文件 是 select.html， 主 要 实现 代码 如 下 。 


<script src="./js/jquery.js"></script> 
<script src="./js/jquery.mobile-1.2.0.js"></script> 
<!-- <script src="./cordova-2.1.0.js"></script> --> 
</head> 
<body> 
<body> 
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<!-- Home --> 
ait 


<div data-role="page" id="pagel"> 
<div data-theme="e" data-role="header"> 


<a data-role-"button" href="./main.html" data-icon="back" 


class="ui-btn-left"> 返 回 </a> 


data-iconpos="left" 


«a data-role-"button" href-".main.html" data-icon="home" data-iconpos="right" 


class="ui-btn-right"> 首 页 </a> 
<h3> 查询 </h3> 
<div> 


<fieldset data-role="controlgroup" data-mini="true"> 


<input name="" id="searchinput6" placeholder=" 输入 联系 人 姓名 " 


value="" type="search" /> 


</fieldset> 
</div> 
<div> 
<input type="submit"  id-"search" data-theme="e" 
data-iconpos-"left" value=" ifj" data-mini="true" /> 
</div> 


</div> 


<div data-role 


—" 


content"> 
«div class="ui-grid-b" id="contents" > 
</div > 
</div> 
<script> 
//App custom javascript 
var u_name= 
<!-- 查询 全 部 联系 人 --> 
/ 等 竺 加载 PhoneGap 
document.addEventListener("deviceready", onDeviceReady, false); 
// PhoneGap 加 载 完 毕 
function onDeviceReady() { 


mm. 
H 


data-icon: 


search" 


var db = window.openDatabase(" Database", "1.0", "PhoneGap myuser", 200000); 
db.transaction(queryDB, errorCB); /调用 queryDB 查询 方法 ， 以 及 errorCB 错 


误 回 调 方法 
j 
/ 查询 数据 库 
function queryDB(tx) { 


tx.executeSql(‘SELECT * FROM myuser’, [], querySuccess, errorCB); 


} 
/ 查询 成 功 后 调用 的 回调 函数 
function querySuccess(tx, results) { 


var len = results.rows.length; 


var  str-"«div  class-'ui-block-a'  style-'width:90px;^ 姓 名 </div><div 


class="ui-block-b'> Hi ti</div><div class-'ui-block-c'»JA </div>"; 
console.log("myuser table: " + len + " rows found."); 
for (var i-0; i<len; 1++){ 
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// 写 入 到 logcat 文件 


str +="<div class—ui-block-a' 
style='width:90px;'>"+results.rows.item(i).user_name+"</div><div 
class='ui-block-b'>"+results.rows.item(1).user_phone 
+"</div><div class="ui-block-c'><a 
href"'tel:"+results.rows.item(i).user_phonet"  data-role-'button' class='ui-btn-right' > 拨打 </a></div>"; 
j 
$("#contents").html(str); 
j 
/ SEAT HU RU RE IRE 
function errorCB(err) { 
console.log("Error processing SQL: "+err.code); 


函数 


E 


} 

<!-- 查询 一 条 数据 ”--> 

$("#search").click(function(){ 
var searchinput6 = $("#searchinput6").val(); 
u_name = searchinput6; 
var db = window.openDatabase("Database", "1.0", "PhoneGap myuser", 200000); 
db.transaction(queryDBbyone, errorCB); 

J); 

function queryDBbyone(tx) { 

tx.executeSql( SELECT * FROM myuser where user name like '%"+u_namet+"%""" 
IL querySuccess, errorCB); 
j 
</script> 
</div> 
</body> 
</html> 


15.5 “实现 系统 管理 模块 


系统 管理 模块 的 功能 是 管理 设备 内 的 联系 人 信息 ， 单 击 图 15-3 中 的 “管理 ”按钮 后 跳 转 
到 系统 管理 界面 ， 如 图 15-6 所 示 。 


编号 姓名 电话 
aaa 13000000000 


图 15-6 系统 管理 界面 
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在 图 15-5 所 示 的 界面 中 提供 了 实现 系统 管理 的 5 个 按钮 ， 具 体 说 明 如 下 。 
O 搜索 单 击 此 按钮 后 能 够 快速 搜索 设备 内 需要 查询 的 联系 人 信息 。 
口 添加 : 单 击 此 按钮 后 能 够 向 设备 内 添加 新 的 联系 人 信息 。 
O 修改 : 单 击 此 按钮 后 能 够 修改 设备 内 已 经 存在 的 某 条 联系 人 信息 。 
O 删除 : 单 击 此 按钮 后 删除 设备 内 已 经 存在 的 某 条 联系 人 信息 。 

O 更 新 : 单 击 此 按钮 后 能 够 更 新 设备 的 所 有 联系 人 信息 。 

系统 管理 模块 的 实现 文件 是 sethtml， 主 要 实现 代码 如 下 。 


<body> 
<!-- Home --> 
<div data-role="page" id-"set 1" data-dom-cache="false"> 
<div data-theme="e" data-role="header" > 


<a data-role-"button" href="main.html" data-icon-"home" data-iconpos="right" 
class="ui-btn-right"> 主页 </a> 
<hl1> 管 理 </h1> 


«a data-role-"button" href="main.html"  data-icon-"back" data-iconpos="left" 


class="ui-btn-left"> 后 退 </a> 
<div > 
<span id="test"></span> 
<fieldset data-role="controlgroup" data-mini="true"> 
<input name-"" id-"searchinputl" placeholder=" 输 入 查询 人 的 姓名 " 


value="" type="search" /> 
</fieldset> 
</div> 
<div> 
<input type="submit" id="search" data-inline="true" data-icon="search" 
data-iconpos-"top" value=" 搜 索 " /> 
<input type="submit" id="add" data-inline-"true" € data-icon="plus" 
data-iconpos="top" value=" 添 加 "> 
<input type="submit" id="modfiry"data-inline="true" data-icon="minus" 
data-iconpos="top" value="{B p" /> 
<input type="submit"  id-"delete" data-inline="true" ` data-icon-"delete" 
data-iconpos="top" value=" 删 除 " /> 
<input type="submit" id="refresh" data-inline="true" ` data-icon-"refresh" 


data-iconpos="top" value=" 更 新 " /> 

</div> 

</div> 

<div data-role="content"> 

<div class="ui-grid-b" id="contents"> 
</div > 

</div> 

<script type="text/javascript"> 
$.mobile.page.prototype.options.domCache = false; 


varu name- ; 


var num-""; 
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"mt. 
H 


var strsql= 
<!-- 查询 全 部 联系 人 -> 
/ 等 待 加 载 PhoneGap 


document.addEventListener("deviceready", onDeviceReady, false); 


// PhoneGap 加 载 完 毕 
function onDeviceReady() { 


var db = window.openDatabase("Database", "1.0", "PhoneGap myuser", 200000); 


db.transaction(queryDB, errorCB); / 调 月 


Eé 
Sti 


调 方法 


} 
/ 查询 数据 库 
function queryDB(tx) { 
tx.executeSgl( SELECT * FROM myuser', 


} 
/ 查询 成 功 后 调用 的 回调 函数 
function querySuccess(tx, results) { 
var len = results.rows.length; 


H queryDB 查询 方法 ， 以 及 errorCB 


IL querySuccess, errorCB); 


var str="<div class='ui-block-a> Zi 号 </div><div class-'ui-block-b'^ V 名 


</div><div class='"ui-block-c 作 电话 </div>"; 
for (var i=0; i<len; 1++){ 


str +="<div class='ui-block-a'><input type-'checkbox' class-'idvalue' 


value="+results.rows.item(1).user_id+" /></div><div class'ui-block-b'>"+resu 
+"</div><div 
class='ui-block-c'>"+results.rows.item(i).user_phone+"</div>"; 
} 
$("#contents").html(str); 
} 
// 事务 执行 出 错 后 调用 的 回调 函数 


function errorCB(err) { 


iH 


Its.rows.item(i).user name 


console.log("Error processing SQL: "+err.code); 


} 
<!-- 查询 一 条 数据 -> 
$("#search").click(function() { 


var searchinputl = $("#searchinput1").val(); 


u name = searchinput1; 


var db = window.openDatabase("Database", "1.0", "PhoneGap myuser", 


200000); 
db.transaction(queryDBbyone, errorCB); 
Di 
function queryDBbyone(tx) { 


tx.executeSql("SELECT * FROM myuser where user name like 
'%"+u_name+"%"'", [], querySuccess, errorCB); 


j 

$("#delete").click(function() { 
var len = $("input:checked"). length; 
for(var i=0;i<len;i++) { 
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num +=","+$("input:checked")[i].value; 
} 
num=num.substr(1); 
var db = window.openDatabase(" Database", "1.0", "PhoneGap myuser", 200000); 
db.transaction(deleteDBbyid, errorCB); 
Ir 
function deleteDBbyid(tx) ( 
tx.executeSgl(" DELETE FROM 'myuser WHERE user id in("+num+")", TL 
queryDB, errorCB); 


$("#add").click(function() ( 
$.mobile.changePage ('add.html', 'fade', false, false); 
Ir 
$("#modfiry").click(function() { 
if($("input:checked").length==1) { 
var userid-$("input:checked").val(); 
sessionStorage.setItem("uid" userid); 
$.mobile.changePage ('modfiry.html', 'fade', false, false); 
}else{ 
alert(" 请 选择 要 修改 的 联系 人 ， 并 且 每 次 只 能 选择 一 位 "); 


Th 


Di 
// 与 手机 联系 人 同步 数据 
$("#refresh").click(function() f 

/ 从 全 部 联系 人 中 进行 搜索 


var options = new ContactFindOptions(); 


options. filter=""; 
var filter = ["displayName","phoneNumbers"]; 
options.multiple=true; 
navigator.contacts.find(filter, onTbSuccess, onError, options); 
Dk 
// onSuccess: 返回 当前 联系 人 结果 集 的 快照 

function onTbSuccess(contacts) { 
/ 显示 所 有 联系 人 的 地 址 信息 
var str="<div class='ui-block-a > 编号 </div><div class='ui-block-b> 姓 名 
</div><div class=mui-block-c> 电 话 </div>"; 
Var phone; 
var db = window.openDatabase("Database", "1.0", "PhoneGap myuser", 200000); 
for (var i=0; i<contacts.length; i++) { 


for(var j=0; j« contacts[1].phoneNumbers.length; j++) ( 
phone = contacts[1].phoneNumbers[; ]. value; 
} 
strsql +="INSERT INTO 'myuser (user name user phone') VALUES 
(""+contacts[i].displayName+","+phone+");#"; 
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db.transaction(addBD, errorCB); 
} 
/ 更 新 插入 数据 
function addBD(tx){ 
strs=strsql.split("#"); 
for(var i=0;i<strs.length;i++) { 
tx.executeSgql(strs[i], [], [], errorCB); 
j 
var db = window.openDatabase("Database", "1.0", "PhoneGap myuser", 200000) 
db.transaction(queryDB, errorCB); 
j 


^ 


// onError: 获取 联系 人 结果 集 失 败 
function onError() { 


console.log("Error processing SQL: "+err.code); 
} 


</script> 
</div> 
</body> 


15.6 ”实现 信息 添加 模块 


在 图 15-5 所 示 的 界面 中 提供 了 实现 系统 管理 


的 S 个 按钮 ， 如 果 单 
转 到 信息 添加 界面 ， 通 过 此 界面 可 以 向 设备 中 添加 新 的 联系 人 信 ， 


击 “ 添 加 ”按钮 则 会 跳 
息 ， 如 图 15-7 所 示 。 


图 


15-7 信息 添加 界 
信息 添加 模块 的 实现 文件 是 add.html， 主 要 实现 代码 如 下 。 
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<body> 
<!-- Home --> 
<div data-role="page" id="pagel"> 
<div data-theme="e" data-role="header"> 


<a data-role="button" id="tjlxr" data-theme="e" data-icon="info" 
data-iconpos="right" class="ui-btn-right"> 保 存 </a> 


<h3> 添 加 联系 人 </h3> 


<a data-role="button" id-"czlxr' ` data-theme-"e" data-icon="refresh" 
data-iconpos="left" class="ui-btn-left"> SS 
</div> 


<div data-role="content"> 
<form action="" data-theme="e" > 
<div data-role="fieldcontain"> 


<fieldset data-role="controlgroup" data-mini="true"> 


«label for="textinputl"> WE 名 : <input name-"" id-"textinputl" 
placeholder="KA A Jt 44" value="" type="text" /></label> 
</fieldset> 
<fieldset data-role="controlgroup" data-mini="true"> 


<label for="textinput2"> H if: ^ «input name-"" id-"textinput2" 
placeholder=" 联 系 人 电话 " value="" type="tel" /></label> 
</fieldset> 


<fieldset data-role="controlgroup" data-mini="true"> 
<label for="textinput3">QQ : <input name=""  id-"textinput3" 
placeholder="" value="" type="number" /></label> 
</fieldset> 
<fieldset data-role="controlgroup" data-mini="true"> 
<label for="textinput4">Emai : <input name-"" id="textinput4" 
placeholder="" value="" type="email" /></label> 
</fieldset> 
<fieldset data-role="controlgroup"> 
<label for="textareal"> 备注 : </label> 


<textarea name-"" id-"textareal" placeholder="" 
data-mini="true"></textarea> 
</fieldset> 
</div> 
<div> 
<a data-role="button" id="back" data-theme="e" > 返回 </a> 
</div> 
</form> 


</div> 
<script type="text/javascript"> 
$.mobile.page.prototype.options.domCache = false; 


var textinputl = 


var textinput2 


=i 
, 
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wi, 
H 


var textinput3 = 


var textinput4 


= We 
, 


=<, 
, 


var textareal 
$("#tjlxr").click(function() ( 
textinputl = $("#textinput1").val(); 
textinput2 = $("#textinput2").val(); 
textinput3 = $("'#textinput3").val(); 
textinput4= $("#textinput4").val(); 
textareal = $("#textareal").val(); 
var db = window.openDatabase("Database", "1.0", "PhoneGap myuser", 200000); 
db.transaction(addBD, errorCB); 
J) 
function addBD(tx){ 
tx.executeSql("INSERT INTO  'myuser (user name', user phone', user qq ， 
"user email "user bz) VALUES ('"+textinputl+"","+textinput2+","+textinput3+",'"+textinput4+",""+textareal+")", 
[], successCB, errorCB); 
} 
$("#ezlxr").click(function() { 
$("#textinput1").val(""); 
$("#textinput2").val(""); 
$("#textinput3").val(""); 
$("#textinput4").val(""); 
$("#textareal").val(""); 
J) 
$("#back").click(function() { 
successCB(); 
J) 
/ 等 竺 加载 PhoneGap 
document.addEventListener("deviceready", onDeviceReady, false); 
// PhoneGap 加 载 完 毕 
function onDeviceReady() { 
var db = window.openDatabase("Database", "1.0", "PhoneGap myuser", 200000); 
db.transaction(populateDB, errorCB); 
/ 填充 数据 库 
function populateDB(tx) { 
tx.executeSql((CREATE TABLE IF NOT EXISTS ‘myuser’ (user id integer 
primary key autoincrement , user name’ VARCHAR( 25 ) NOT NULL user phone’ varchar( 15 ) NOT 
NULL , user qq varchar( 15 ) user email VARCHAR( 50 ), user bz TEXT); 
} 
/ 事务 执行 出 错 后 调用 的 回调 函数 


function errorCB(tx, err) { 


alert("Error processing SQL: "+err); 
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/ 事务 执行 成 功 后 调用 的 回调 函数 
function successCB() { 
$.mobile.changePage (‘set.html', 'fade', false, false); 
j 
</script> 
</div> 
</body> 


15.7 “实现 信息 修改 模块 


| 


在 图 15-5 所 示 的 界面 中 ， 如 果 先 勾 选 一 个 联系 人 信息 ， 然 后 单 击 “ 修 改 ” 按 钮 后 会 来 到 
信息 修改 界面 ， 通 过 此 界面 可 以 修改 这 条 被 选中 联系 人 的 信息 ， 如 图 15-8 所 示 。 


13000000000 


QQ: 
111111 


Emai : 


11111@qq.com 
备注 : 


Sss | 
图 15-8 ”信息 修改 界面 


信息 修改 模块 的 实现 文件 是 modfiry.html， 主 要 实现 代码 如 下 。 


| 


«script type="text/javascript" src-" /js/jquery.js" »«/script^ 
</head> 
<body> 
<!-- Home --> 
<div data-role="page" id="pagel"> 
<div data-theme-"e" data-role="header"> 
<a data-role="button" id="tjlxr" data-theme="e" data-icon="info" 
data-iconpos="right" class="ui-btn-right"> 修 改 </a> 
<h3> 修 改 联系 人 </h3> 


<a data-role="button" id-"back" data-theme="e" data-icon="refresh" 
data-iconpos="left" class="ui-btn-left"> 返回 </a> 
</div> 
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<div data-role="content"> 
<form action="" data-theme="e" > 
<div data-role="fieldcontain"> 


<fieldset data-role="controlgroup" data-mini="true"> 


«label for="textinputl"> WE 名 : <input name="" 
placeholder=" 联 系 人 姓名 " value="" type="text" /></label> 
</fieldset> 


<fieldset data-role="controlgroup" data-mini="true"> 


id="textinput1" 


<label for="textinput2"> H if: ^ «input name-"" id="textinput2" 


placeholder-" Jf Z& A Fi i" value="" type="tel" /></label> 
</fieldset> 
<fieldset data-role="controlgroup" data-mini="true"> 
<label for="textinput3">QQ : <input name="" 
placeholder="" value="" type="number" /></label> 
</fieldset> 
<fieldset data-role="controlgroup" data-mini="true"> 
<label for="textinput4">Emai : <input name="" 
placeholder="" value="" type="email" /></label> 
</fieldset> 
<fieldset data-role="controlgroup"> 
<label for="textareal"> 备注 : </label> 


id="textinput3" 


id="textinput4" 


<textarea name="" id="textareal" placeholder=""_data-mini="true"> 


</textarea> 
</fieldset> 
</div> 
</form> 
</div> 
<script type="text/javascript"> 
$.mobile.page.prototype.options.domCache = false; 


=i 
, 


var textinput1 


=i, 
, 


var textinput2 


"m. 
H 


var textinput3 = 


mm, 
H 


var textinput4 = 
var textareal =""; 
var uid = sessionStorage.getItem("uid"); 


$("#tjlxr").click(function() { 


textinput] = $("#textinput1").val(); 
textinput2= $("#textinput2").val(); 
textinput3 = $("#textinput3").val(); 
textinput4= $("#textinput4").val(); 
textareal = $("#textareal").val(); 


var db = window.openDatabase("Database", "1.0", "PhoneGap myuser", 200000); 


db.transaction(modfiyBD, errorCB); 
» 
function modfiyBD(tx) { 
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tx.executeSql("UPDATE ‘myuser SET ‘user_name’=""+textinputl+"', user_phone* 
="+textinput2+", user qq ="+textinput3 +", user email ="+textinput4+", user bz'—"--textareal--"" WHERE 
user id="+uid, [], successCB, errorCB); 
} 
$("#back").click(function() { 
successCB(); 
D 
document.addEventListener("deviceready", onDeviceReady, false); 
// PhoneGap 加 载 完 毕 
function onDeviceReady() { 
var db = window.openDatabase("Database", "1.0", "PhoneGap myuser", 200000); 
db.transaction(selectDB, errorCB); 
j 
function selectDB(tx) { 
tx.executeSql("SELECT * FROM myuser where user_id="+uid, TL querySuccess, 
errorCB); 
} 
// 事务 执行 出 错 后 调用 的 回调 函数 


function errorCB(tx, err) { 


iH 


alert("Error processing SQL: "+err); 
} 
/ 事务 执行 成 功 后 调用 的 回调 函数 
function successCB() { 
$.mobile.changePage (‘set.html', 'fade', false, false); 
} 
function querySuccess(tx, results) { 
var len = results.rows.length; 
for (var 1-0; i<len; i++) { 

/ 写 入 到 logcat 文件 
$("#textinput1").val(results.rows.item(i).user_name); 
$("#textinput2").val(results.rows.item(i).user_phone); 
$("#textinput3").val(results.rows.item(i).user_qq); 
$("#textinput4").val(results.rows.item(i).user_email); 
$("#textarea1").val(results.rows.item(i).user_bz); 


j 
} 
</script> 
</div> 
</body> 
</html> 


15.8 ”实现 信息 删除 模块 和 更 新 模块 


在 图 15-5 所 示 的 界面 中 ， 如 果 先 勾 选 一 个 联系 人 信息 ， 然 后 单 击 “ 删 除 ” 按 钮 后 
会 删除 这 条 被 勾 选 的 联系 人 信息 。 信 息 删 除 模块 的 功能 在 文件 set.html 中 实现 ， 相 关 的 
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实现 代码 如 下 。 


function deleteDBbyid(tx) { 
tx.executeSql("DELETE FROM ‘myuser WHERE user id in("+num+")", TL queryDB, errorCB); 
j 


在 图 15-5 所 示 的 界面 中 ， 如 果 单 击 “ 更 新 ”按钮 则 会 更 新 整个 设备 内 的 联系 人 信息 。 信 
息 更 新 模块 的 功能 在 文件 set.html 中 实现 ， 相 关 的 实现 代码 如 下 。 


$("#refresh").click(function() { 
/ 从 全 部 联系 人 中 进行 搜索 


var options = new ContactFindOptions(); 


options. filter=""; 
var filter = ["displayName","phoneNumbers"]; 
options.multiple=true; 


navigator.contacts.find(filter, onTbSuccess, onError, options); 
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第 16 5€ 


推出 的 


I 天 软件 。 


By 


用 户 可 以 通过 微 信 与 好 友 进 行 形式 上 
微 信 软件 本 身 完 全 免费 ,使 用 时 产生 的 上 网 流量 费 由 网 络 运营 商 收取 。2012 4E 9 H 17 
发 一 个 微 信 系 统 的 基 


开发 移动 微 信 系统 


短 


言 、 视 频 、 


更 加 丰富 


图 片 和 文 


的 联系 。 
, 微 


， 能 够 实现 在 线 实 时 交流 。 在 本 节 的 


言 注 册 用 户 过 2 亿 。 在 本 章 的 内 容 中 ， 将 简要 介绍 在 Android 平台 : 
本 思路 和 流程 。 
16.1 微 信 系 统 基础 
微 信 系 统 和 QQ 聊天 软件 类 似 ， 也 是 一 球 通 讯 工 具 
内 容 中 ， 将 简要 讲解 微 信 系统 的 基本 知识 。 
16.1.1 微 信 的 特点 
微 信 是 一 种 更 快速 的 即时 通讯 工具 ， 有 具有 零 资 费 、 跨 平台 
能 ， 与 传统 的 短信 沟通 方式 相 比 ， 更 灵活 、 智 能 ， 且 节省 资 
文 持 发 送 语音 短信 、 视 频 、 图 片 〈 包 括 表 情 ) 和 文字 
口 文 持 多 人 群 聊 。 
口 支持 查看 所 在 位 置 附近 使 用 微 信 的 人 LBS 功能 )。 
O 支持 腾讯 微 博 、QQ 邮箱 、 漂 流 瓶 、 语 音 记 事 本 、QQ 同步 助手 等 插件 功能 。 
Q 文 持 视频 聊天 。 
口 微 行情 : 支持 及 时 查询 股票 行情 。 
O 多 平台 ， 支 持 iPhone, Android. Windows Phone, HE, blackberry 平台 的 手机 之 间 
相互 收发 消息 ， 省 流量 。 


16.1.2 MUAT Q 信 的 关系 


Q 信和 是 另 一 款 | 
个 不 同 的 软 人 
CD fA 


Wi 


IF HUT QQ Win 
FF， 可 以 进行 以 下 区 分 。 
上 也 集成 很 多 插件 ， 如 QQ 邮箱 助手 、QQ 离线 助手 、 通 讯 录 安全 助手 等 ，Q 信 


Ve QQ 通讯 录 上 的 


个 功能 ， 没 有 下 层 插件 。 


的 一 个 功能 ， 与 微 信 功 能 极其 相似 。 但 却 是 两 


(2) 微 信 的 好 友 是 基于 手机 通讯 录 中 的 联系 人 和 QQ 上 的 好 友 ， 而 Q 信和 只 基于 手机 通讯 
录 中 的 联系 人 。 


(3) Q 信 上 能 够 显 


(ER 


示 好 友 手 机 号 码 ， 微 信和 只 能 显示 


Pd 
小 


呼 或 者 备注 


能 显示 手机 
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Q 信和 微 信 虽然 基本 功能 一 样 ， 可 以 通过 网 络 快速 发 送 〈 需 消耗 少量 网 络 流量 ) 语音 短 
信 、 视 频 、 图 片 和 文字 ， 支 持 多 人 群 聊 ， 但 却 是 两 个 独立 的 软件 ， 属 腾讯 的 不 同 产品 。 


16.2 ”使 用 Android ViewPager 


在 Android 系统 中 , 谷歌 提供 了 ViewPager 实现 多 页 面 滑动 切换 以 及 动画 效果 。 在 本 章 的 
微 信 系 统 中 ， 将 使 用 ViewPager 来 实现 界面 之 间 的 切换 工作 。 在 下 面 的 内 容 中 ， 将 通过 一 个 
实例 来 讲解 使 用 Android ViewPager 的 基本 流程 。 


实 例 Xj f 源码 路 径 


= 


Android ViewPager 实现 切换 daima\16\DWinterTabDemo 


实例 16-1 


本 实例 的 具体 实现 流程 如 下 。 

C1) 本 实例 需要 用 到 ViewPager 控件 ， 这 是 SDK 中 自 带 的 一 个 附加 包 的 一 个 类 ， 可 以 用 
来 实现 屏幕 间 的 切换 。 使 用 本 控件 需要 在 工程 中 包 android-support-v4.jar， 放 在 libs 文件 夹 中 。 
当然 也 可 以 从 网 上 搜索 最 新 的 版 本 。 本 实例 的 工程 目录 如 图 16-1 所 示 。 


" 


I$ Package Explorer 23 FS NEG 


= GG DWinterTabDemo 
OG sre 
由 gs gen [Generated Java Files] 
"2 Sé, Android 4.3 
Ce, Android Private Libraries 
E (na android-support-v4. jar - C A FEEifEB 2013" 
由 EE) Referenced Libraries 
es assets 
H-E bin 
EG libs 
we, android-support-v4. jar 

由 & res 

加 Androi dMani fest. xml 

default. properties 
i iai lint. xml 


B proguard. cfg 
project.properties 


图 16-1 工程 目录 


E 


(2) 开始 设计 界面 ， 整 个 设计 工作 非常 简单 ， 第 一 行为 3 个 头 标 ， 第 二 行为 动画 图 
第 三 行为 页 卡 内 容 展示 。 布 局 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:umadsdk="http://schemas.android.com/apk/res/com.LoveBus" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:orientation-" vertical" > 
<LinearLayout 
android:id="(@+id/linearLayout1" 
android:layout_width="fill_parent" 
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android:layout_height="100.0dip" 
android:background="#FFFFFF" > 
<TextView 
android:id="(@+id/text1" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:layout weight-" 1.0" 
android:gravity="center" 
android:tex 人 "页 卡 1" 
android:textColor="#000000" 
android:textSize="22.0dip" /> 
<TextView 
android:id="@+id/text2" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:layout weight-" 1.0" 
android:gravity="center" 
android:text-" Ji-F 2" 
android:textColor="#000000" 
android:textSize="22.0dip" /> 
<TextView 
android:id="@+1id/text3" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:layout weight-" 1.0" 
android:gravity="center" 
android:text=" 页 卡 3" 
android:textColor="#000000" 
android:textSize="22.0dip" /> 
</LinearLayout> 
<ImageView 
android:id="@+id/cursor" 
android:layout_width="fill parent" 
android:layout_height="wrap_content" 
android:scaleType="matrix" 
android:src="(@drawable/a" /> 


<android.support.v4.view. ViewPager 
android:id="(@+id/vPager" 


android:layout width-"wrap content" 


android:layout height-"wrap content" 


android:layout_gravity="center" 
android:layout_weight="1.0" 
android:background="#000000" 
android:flipInterval="30" 


android:persistentDrawingCache="animation" /> 
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</LinearLayout> 


因为 本 项 目 需要 展示 3 个 页 卡 ， 所 以 还 需要 3 个 页 卡 内 容 的 界面 设计 ， 这 里 只 设置 了 


AL 
dg 


景 颜色 ， 能 起 到 区 别 作 


] 即 可 。 具 体 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 


android:layout height-"fill parent" 


android:orientation-" vertical" 
android:background="#158684" > 


</LinearLayout> 


(3) 接 下 来 开始 具体 编码 工作 ， 首 先进 行 初 始 化 的 工作 ， 实 现 变量 的 定义 的 代码 如 下 。 


private ViewPager 


mPager;// 页 卡 内 容 


private List<View> listViews; // Tab 页 面 列表 
private ImageView cursor;// 动画 图 片 


private TextView t 
private int offset = 


private int currIndex = 0;// > 


1, t2, 3;// 页 卡 头 标 
0;// 动画 图 片 偏 移 量 


ie = 
=e 
Jr 
SCH 
du 


private int bmpW;// 动画 图 片 宽 度 


OQ 初始 化 头 标 并 响 


[** 


应 点 击 事件 的 实现 代码 如 下 。 


* 初始 化 头 标 


vil 
private void 


InitTextView() ( 


tl =(TextView) findViewByld(R.id.text1); 
t2 =(TextView) findViewByld(R.id.text2); 
t3 =(TextView) findViewByld(R.id.text3); 
tl.setOnClickListener(new MyOnClickListener(0)); 
t2.setOnClickListener(new MyOnClickListener(1)); 
t3.setOnClickListener(new MyOnClickListener(2)); 


[** 


* SLR kid 
*/ 


FT 


public class MyOnClickListener implements View.OnClickListener { 


private 


int index = 0; 


public MyOnClickListener(int 1) { 
index = i; 


j 


@Override 
public void onClick( View v) { 
mPager.setCurrentItem(index); 
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口 初始 化 页 卡 内 容 区 的 实现 代码 如 下 。 


[** 


Se 


O 将 3 个 页 卡 界面 装 入 其 中 ， 默认 显示 第 一 个 页 卡 。 在 此 处 还 需要 通过 代码 实现 一 个 适 
LAXE s 


Rises 


[** 


vit 


* 初始 化 ViewPager 


private void InitViewPager() { 


j 


mPager = (ViewPager) find ViewByld(R.id.vPager); 

listViews = new ArrayList<View>(); 

LayoutInflater mInflater = getLayoutInflater(); 

list Views.add(mlInflater.inflate(R.layout.lay1, null)); 

list Views.add(mInflater.inflate(R.layout.lay2, null)); 

list Views.add(mInflater.inflate(R.layout.lay3, null); 
mPager.setAdapter(new MyPagerA dapter(listViews)); 
mPager.setCurrentltem(0); 

mPager.setOnPageChangeListener(new MyOnPageChangeListener()); 


d 


* ViewPager 适配器 


public class MyPagerAdapter extends PagerAdapter { 


public List<View> mListViews; 

public MyPagerAdapter(List<View> mListViews) { 
this. mList Views = mListViews; 

j 

@Override 

public void destroyItem(View arg0, mt arg1, Object arg2) { 
((ViewPager) arg0).removeView(mListViews.get(arg1)); 

} 

@Override 

public void finishUpdate(View arg0) { 

} 

@Override 

public int getCount() { 
return mListViews.size(); 

} 

@Override 

public Object instantiateItem(View arg0, int argl) { 
((ViewPager) arg0).addView(mListViews.get(arg1), 0); 
return mListViews.get(arg1); 
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@Override 

public boolean isViewFromObject(View arg0, Object arg1) { 
return arg0 == (arg1); 

j 

@Override 

public void restoreState(Parcelable arg0, ClassLoader arg1) { 

} 

@Override 

public Parcelable saveState() { 
return null; 

} 

@Override 

public void startUpdate(View arg0) { 

} 

} 


BUC IE, SILT UB BA ACT Eo 
口 初始 化 动画 的 实现 代码 如 下 。 


[** 


* 初始 化 动画 
i 
private void InitImageView() { 
cursor = (Image View) findViewById(R..id.cursor); 
bmpW = BitmapFactory.decodeResource(getResources(), R.drawable.a) 
.getWidth();/ 获取 图 片 宽度 
DisplayMetrics dm = new DisplayMetrics(); 
getWindowManager().getDefaultDisplay().getMetrics(dm); 
int screenW = dm.widthPixels;// 获取 分 辨 率 宽 度 
offset = (screenW /3 - bmpW) / 2;// 计算 偏 移 量 
Matrix matrix = new Matrix(); 


matrix.postTranslate(offset, 0); 
cursor.setImageMatrix(matrix);/ 设置 动画 初始 位 


} 
O 实现 页 卡 切换 监听 事件 的 处 理 代码 如 下 。 


[** 


* 页 卡 切换 监听 
s 
public class MyOnPageChangeListener implements OnPageChangeListener { 
int one = offset * 2 + bmpW;// 页 卡 1 -> 页 卡 2 m: 
int two = one * 2;// WFR 1 -> 页 卡 3 MEE 
@Override 
public void onPageSelected(int argO) { 


Sr 


Animation animation = null; 
switch (arg0) { 
case 0: 
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if (currIndex == 1) { 
animation = new TranslateAnimation(one, 0, 0, 0); 
} else if (currIndex == 2) { 
animation = new TranslateAnimation(two, 0, 0, 0); 
j 
break; 
case 1: 
if (currIndex == 0) ( 
animation — new TranslateAnimation(offset, one, 0, 0); 
} else if (currIndex == 2) { 
animation = new TranslateAnimation(two, one, 0, 0); 
} 
break; 
case 2: 
if (currIndex == 0) { 
animation = new TranslateAnimation(offset, two, 0, 0); 
} else if (currIndex == 1) { 
animation = new TranslateAnimation(one, two, 0, 0); 
} 
break; 
} 
currIndex = arg0; 
animation.setFillA fter(true);// True: 图 片 停 在 动画 结束 位 置 
animation.setDuration(300); 
cursor.startAnimation(animation); 


j 
@Override 
public void onPageScrolled(int arg0, float argl, int arg2) { 
j 
@Override 
public void onPageScrollStateChanged(int argO) f 
j 
j 


到 此 为 止 ， 整 个 实例 介绍 完毕 ， 执 


M 


J 后 会 实现 动画 切换 效果 ， 如 图 16-2 所 示 。 


DWinterTabDemo DWinterTabDemo 


图 16-2 执行 效果 
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16.3 ”开发 一 个 微 信 系统 


在 本 节 的 内 容 中 ， 将 通过 一 个 具体 实例 的 实现 过 程 ， 讲 解 开发 一 个 Android 微 信 系统 的 


实 d D 能 源码 路 径 
实例 16-2 开发 一 个 微 信 系 统 daima\16\Weixin 


16.31 启动 界面 


使 用 过 微 信 的 用 户 都 知道 ， 每 次 启动 程序 都 会 出 现 一 个 启动 画面 ， 如 果 是 第 一 次 使 用 则 
还 会 出 现 后 面 的 导航 界面 。 当 本 实例 启动 后 会 进入 第 一 个 Activity， 此 Activity 就 是 一 个 启动 
画面 ， 之 后 会 在 这 个 Activity 里 面 设 置 一 个 Handler 去 延迟 (1 秒 ， 数 值 可 以 自己 设 定 ) 执行 
启动 导航 界面 的 Activity。 
启动 界面 的 UI 文件 是 appstartxml， 有 具体 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
android:background="(@drawable/welcome" > 


</LinearLayout> 


启动 界面 的 实现 文件 是 Appstartjava， 有 具体 代码 如 下 。 


package cn.buaa.myweixin; 
import android.os.Bundle; 
import android.os.Handler; 
import android.app.Activity; 
import android.content.Intent; 
import android.view.Menu; 
import android.view. WindowManager; 
public class Appstart extends Activity 
@Override 
public void onCreate(Bundle savedInstanceState) { 
// TODO Auto-generated method stub 
super.onCreate(savedInstanceState); 
setContentView(R.layout.appstart); 
new Handler().postDelayed(new Runnable() ( 


public void run() { 
Intent intent = new Intent (Appstart.this, Welcome.class); 
startA ctivity(intent); 
Appstart.this.finish(); 
j 
}, 1000); 
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} 
执行 后 的 效果 如 图 16-3 所 示 。 


图 16-3 ”执行 效果 


16.32 ”系统 导航 界面 
进入 系统 后 ， 会 在 界面 下 方 显示 导航 选项 卡 ， 分 别 显 示 “ 微 信 ”“ 通 讯 录 “朋友 们 ”和 
“设置 ”4 个 选项 ， 如 图 16-4 所 示 。 


Sj Palette s (alg ee EE EI 
L> Form Vidgets 

Ab TextView 

Ab Large Text 

Ab Medium Text 

Ab Small Text 

=> Button 

." ToggleButton 

(^ CheckBox 

* RadioButton 

Chi CheckedTextVi ew 

_* Spinner 

Q ProgressBar (Large) 
OQ ProgressBar (Normal) 
© Text Fields 

(5 Layouts 

[D Composite 

C Images & Media 
© Time & Date 


(> Transitions 


C Advanced d = à oi 了 | 
(C Custom & Library Ni, b 


E Graphical Layout | 三 | main weixin. xml 


图 16-4 “导航 选项 卡 的 设计 界 盏 
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导航 界面 的 布局 文件 是 main_weixin.xml， 具 体 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@-+id/mainweixin" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


android:orientation-" vertical" 
android:background-" eee" > 
«RelativeLayout 
android:id="(@+id/main_bottom" 


android:layout_width="match_parent" 
android:layout_height="55dp" 
android:layout_alignParentBottom="true" 
android:orientation="Vvertical" 
android:background="(@drawable/bottom_bar"> 
<ImageView 
android:id="@+id/img_tab_now" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:scaleType="matrix" 
android:layout_gravity="bottom" 
android:layout_alignParentBottom="true" 
android:src="(@drawable/tab_bg" /> 
<LinearLayout 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:layout_alignParentBottom="true" 


android:paddingBottom="2dp"> 


<LinearLayout 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:gravity-"center horizontal" 
android:orientation-" vertical" 
android:layout_weight="1"> 
<ImageView 
android:id="@-+id/img weixin" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:scaleType-" matrix" 
android:clickable-"true" 


ERI 


android:src-"(a)drawable/tab weixin pressed" /> 
<TextView 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
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android:text=" 微 信 " 
android:textColor="#fff" 
android:textSize="12sp" /> 
</LinearLayout> 
<LinearLayout 


ERI 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:gravity-"center horizontal" 
android:orientation-" vertical" 
android:layout_weight="1"> 
<ImageView 
android:id="(@+id/img_ address" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:scaleType-" matrix" 
android:clickable-"true" 
android:src-"(a)drawable/tab address normal" /> 
«TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 通 讯 录 " 
android:textColor="#fft" 
android:textSize="12sp" /> 
</LinearLayout> 


<LinearLayout 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:gravity-"center horizontal" 
android:orientation-" vertical" 
android:layout_weight="1"> 
<ImageView 
android:id="@-+id/img_friends" 


android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:scaleType-" matrix" 
android:clickable-"true" 
android:src-"(a)drawable/tab find frd normal" /> 
<TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 朋 友 们 " 
android:textColor="#fff" 
android:textSize="12sp" /> 
</LinearLayout> 


<LinearLayout 
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android:layout width-"wrap content" 


android:layout height-"wrap content" 


android:gravity-"center horizontal" 
android:orientation-" vertical" 
android:layout_weight="1"> 
<ImageView 
android:id="@-+id/img_settings" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 


android:scaleType-" matrix" 
android:clickable-"true" 
android:src-"(a)drawable/tab settings normal" /> 
«TextView 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-" v ën 
android:textColor="#fff" 

android:textSize="12sp" /> 


</LinearLayout> 


</LinearLayout> 


</RelativeLayout> 
<LinearLayout 
android:layout_width="fill_parent" 


android:layout_height="wrap_content" 
android:layout_alignParentTop="true" 
android:layout_above="@id/main_bottom" 


android:orientation="vertical" > 
<android.support.v4.view. ViewPager 
android:id="@+id/tabpager" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_gravity="center" > 
</android.support.v4. view ViewPager> 
</LinearLayout> 


</RelativeLayout> 


对 应 的 实现 文件 是 MainWeixin.java， 有 具体 代码 如 下 。 


package cn.buaa.myweixin; 

import java.util. ArrayList; 

import android.os.Bundle; 

import android.app.Activity; 

import android.content. Intent; 

import android.support.v4.view. PagerA dapter; 
import android.support.v4.view. ViewPager; 
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import android.support.v4.view. ViewPager.OnPageChangeL istener; 
import android.view. Display; 
import android.view.Gravity; 
import android.view.KeyEvent; 
import android. view.LayoutInflater; 
import android.view. View; 
import android.view. WindowManager; 
import android.view.WindowManager. LayoutParams; 
import android.view.animation.Animation; 
import android.view.animation.TranslateAnimation; 
import android.widget.ImageView; 
import android.widget.LinearLayout; 
import android.widget.PopupWindow; 
public class MainWeixin extends Activity { 
public static MainWeixin instance = null; 
private ViewPager mTabPager; 
private ImageView mTabImg;// 动画 图 片 
private ImageView mTab1, mTab2, mTab3, mTab4; 
private int zero = 0;// 动画 图 片 偏 移 量 
private int currIndex = 0;// 当前 页 卡 编号 
private int one 单个 水 平 动画 位 移 
private int two; 


private int three; 

private LinearLayout mClose; 

private LinearLayout mCloseBtn; 

private View layout; 

private boolean menu display = false; 

private Popup Window menuWindow; 

private LayoutInflater inflater; 

@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main weixin); 
// 启动 Activity 时 不 自动 弹出 软 键 盘 
getWindow().setSoftInputMode( 


WindowManager.LayoutParams.SOFT INPUT STATE ALWAYS HIDDEN); 


instance = this; 
mTabPager = (ViewPager) findViewByld(R.id.tabpager); 


mTabPager.setOnPageChangeListener(new MyOnPageChangeListener()); 


mTabl = (ImageView) findViewById(R.id.img weixin); 
mTab2 = (ImageView) findViewByld(R.id.img_ address); 
mTab3 = (ImageView) findViewById(R.id.img. friends); 
mTab4 = (ImageView) findViewById(R.id.img, settings); 


mTabImg = (ImageView) findViewById(R.id.img tab now); 


mTabl.setOnClickListener(new MyOnClickListener(0)); 
mTab2.setOnClickListener(new MyOnClickListener(1)); 
mTab3.setOnClickListener(new MyOnClickListener(2)); 
mTab4.setOnClickListener(new MyOnClickListener(3)); 
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Display currDisplay = getWindowManager().getDefaultDisplay();// 获取 屏幕 当前 分 辩 率 
int display Width = currDisplay.getWidth(); 

int displayHeight = currDisplay.getHeight(); 

one = displayWidth / 4; // 设置 水 平 动画 平移 大 小 

two = one * 2; 

three = one * 3; 

/ 将 要 分 页 显示 的 View 装 入 数组 中 

LayoutInflater mLi = LayoutInflater.from(this); 

View viewl = mLi.inflate(R.layout.main tab weixin, null); 


View view2 — mLi.inflate(R.layout.main tab address, null); 
View view3 — mLi.inflate(R.layout.main tab friends, null); 
View view4 — mLi.inflate(R.layout.main tab settings, null); 
/ 每 个 页 面 的 view 数据 

final ArrayList<View> views = new ArrayList<View>(); 


views.add(view 1); 
views.add(view2); 
views.add(view3); 
views.add(view4); 
// 填充 ViewPager 的 数据 适配器 
PagerAdapter mPagerAdapter = new PagerAdapter() { 
@Override 
public boolean isViewFromObject(View arg0, Object arg1) { 
return arg0 == arg1; 
} 
@Override 
public int getCount() { 
return views.size(); 
} 
@Override 
public void destroyItem(View container, int position, Object object) { 
((ViewPager) container).removeView(views.get(position)); 
} 
@Override 
public Object instantiateItem(View container, int position) { 
((ViewPager) container).addView(views.get(position)); 
return views.get(position); 


h 
mTabPager.setAdapter(mPagerAdapter); 
j 
[** 
* 头 标点 击 监听 
E 
public class MyOnClickListener implements View.OnClickListener { 
private int index — 0; 
public MyOnClickListener(int i) { 
index = i; 
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public void onClick(View v) { 
mTabPager.setCurrentItem(index); 


j 
D 
/* 
* 页 卡 切换 监听 (原作 者 :D.Winter) 
E 


public class MyOnPageChangeListener implements OnPageChangeListener { 
public void onPageSelected(int argO) { 
Animation animation — null; 
switch (arg0) { 
case 0: 
mTabl.setImageDrawable(getResources().getDrawable( 
R.drawable.tab weixin pressed)); 
if (currIndex == 1) { 
animation — new TranslateAnimation(one, 0, 0, 0); 
mTab2.setImageDrawable(getResources().getDrawable( 
R.drawable.tab address normal)); 
} else if (currIndex == 2) { 
animation — new TranslateAnimation(two, 0, 0, 0); 
mTab3.setImageDrawable(getResources().getDrawable( 
R.drawable.tab find frd normal)); 
} else if (currIndex == 3) ( 
animation = new TranslateAnimation(three, 0, 0, 0); 
mTab4.setImageDrawable(getResources().getDrawable( 
R.drawable.tab settings normal)); 
} 
break; 
case 1: 
mTab2.setImageDrawable(getResources().getDrawable( 
R.drawable.tab address pressed)); 
if (currIndex == 0) { 
animation = new TranslateAnimation(zero, one, 0, 0); 
mTabl.setImageDrawable(getResources().getDrawable( 
R.drawable.tab weixin normal)); 
} else if (currIndex == 2) { 
animation = new TranslateAnimation(two, one, 0, 0); 
mTab3.setImageDrawable(getResources().getDrawable( 
R.drawable.tab find frd normal)); 
} else if (currIndex == 3) ( 
animation = new TranslateAnimation(three, one, 0, 0); 
mTab4.setImageDrawable(getResources().getDrawable( 
R.drawable.tab settings normal)); 
} 
break; 
case 2: 
mTab3.setImageDrawable(getResources().getDrawable( 
R.drawable.tab find frd pressed)); 
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if (currIndex == 0) { 
animation = new TranslateAnimation(zero, two, 0, 0); 
mTabl.setImageDrawable(getResources().getDrawable( 
R.drawable.tab weixin normal)); 
} else if (currIndex == 1) ( 
animation — new TranslateAnimation(one, two, 0, 0); 
mTab2.setImageDrawable(getResources().getDrawable( 
R.drawable.tab address normal)); 
} else if (currIndex == 3) ( 
animation = new TranslateAnimation(three, two, 0, 0); 
mTab4.setImageDrawable(getResources().getDrawable( 
R.drawable.tab settings normal)); 


j 
break; 
case 3: 
mTab4.setImageDrawable(getResources().getDrawable( 
R.drawable.tab settings pressed)); 
if (currIndex == 0) { 
animation — new TranslateAnimation(zero, three, 0, 0); 
mTabl.setImageDrawable(getResources().getDrawable( 
R.drawable.tab weixin normal)); 
} else if (currIndex == 1) { 
animation = new TranslateAnimation(one, three, 0, 0); 
mTab2.setImageDrawable(getResources().getDrawable( 
R.drawable.tab address normal)); 
} else if (currIndex == 2) { 
animation = new TranslateAnimation(two, three, 0, 0); 
mTab3.setImageDrawable(getResources().getDrawable( 
R.drawable.tab find frd normal)); 
j 
break; 
} 
currIndex = arg0; 
animation.setFillA fter(true);// True: 图 片 停 在 动画 结束 位 置 
animation.setDuration(150);// 动画 持续 时 间 
mTabImg.startAnimation(animation);// 开始 动画 


public void onPageScrolled(int arg0, float arg1, int arg2) { 
j 


public void onPageScrollStateChanged(int arg0) { 


} 


} 
@Override 


public boolean onKeyDown(int keyCode, KeyEvent event) { 
// 获 取 back 键 
if (keyCode == KeyEvent. KEYCODE BACK SE event.getRepeatCount()== 0) { 
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if (menu display) { 
/ WR Menu 已 经 打开 ， 先 关闭 Menu 
menuWindow.dismiss(); 


menu_display = false; 

} else { 
Intent intent = new Intent(); 
intent.setClass(MainWeixin.this, Exit.class); 
startActivity(intent); 


else if (keyCode == KeyEvent KEYCODE MENU) { A 获取 Menu 键 
if (!Imenu display) { 
// 获取 LayoutInflater 实例 
inflater = (LayoutInflater) this 
.getSystemService(LAYOUT INFLATER SERVICE); 
/ 这 里 的 main 布局 是 在 inflate 中 加 入 的 
A 该 方法 返回 的 是 一 个 View 的 对 象 ， 是 布局 中 的 根 
layout = inflater.inflate(R.layout.main_menu, null); 
/ 后 两 个 参数 是 width 和 height 
menuWindow = new PopupWindow(layout, LayoutParams.FILL PARENT, 
LayoutParams. WRAP. CONTENT); 
menuWindow.showAtLocation(this.findViewByld(R.id.mainweixin), 
/ WE layout 在 PopupWindow 中 显示 的 位 置 
Gravity. BOTTOM | Gravity. CENTER HORIZONTAL, 0, 0); 
mClose = (LinearLayout) layout.findViewById(R.id.menu close); 
mCloseBtn = (LinearLayout) layout 
.findViewById(R.id.menu close btn); 
/ 下 面 对 每 一 个 Layout 进行 点 击 事件 的 注册 
mCloseBtn.setOnClickListener(new View.OnClickListener() { 
public void onClick( View arg0) { 


Intent intent = new Intent(); 
intent.setClass(MainWeixin.this, Exit.class); 


startActivity (intent); 
/ 响应 点 击 事件 之 后 关闭 Menu 
menuWindow.dismiss(); 
j 
» 
menu display = true; 
} else { 


/ 如 果 当 前 已 经 为 显示 状态 ， 则 隐藏 起 来 
menu Window.dismiss(); 
menu_display = false; 


} 

return false; 
} 
return false; 
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/ 设置 标题 栏 右 侧 按钮 的 作用 
public void btnmainright(View v) { 
Intent intent = new Intent(MainWeixin.this, MainTopRightDialog.class); 
startActivity(intent); 


} 


public void startchat(View v) { 
Intent intent = new Intent(MainWeixin.this, ChatActivity.class); 
startActivity(intent); 

j 

public void exit settings(View v) { 
Intent intent = new Intent(MainWeixin.this, ExitFromSettings.class); 
startActivity (intent); 

j 

A ERU HR 

public void btn shake(View v) { 
Intent intent = new Intent(MainWeixin.this, ShakeActivity.class); 
startA ctivity (intent); 


16.3.3 ”系统 登录 界面 
为 了 保证 系统 的 安全 ， 设 置 只 有 合法 用 户 才 能 登录 系统 ， 为 此 专门 设置 了 一 个 登录 于 
界面 。 具 体 UI 界面 如 图 16-5 所 示 。 


(> Fora Widgets 


T 


Large Medium 


heckBox 


© Text Fields 
O Layouts 

C Composite 
(C Images A Media 
(C Time & Date 


[站 Transitions 


C Advanced 


Custom &...ary Views |: > | 


图 16-5 系统 的 登录 表单 界面 


472 EE 


第 16 章 开发 移动 微 信 系统 
系统 登录 界面 的 布局 文件 是 login.xml， 具 体 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:background="#eee" 
android:orientation="Vertical" 
android:gravity="center_horizontal"> 
<RelativeLayout 
android:id="@-+id/login_top layout" 
android:layout_width="fill_parent" 
android:layout_height="45dp" 
android:layout_alignParentTop="true" 
android:background-"(g)drawable/title bar" 
«Button 
android:id="@-+id/login_reback_btn" 
android:layout_width="70dp" 
android:layout_height="wrap_content" 
android:layout_centerVertical="true" 
android:text="i [n|" 
android:textSize="26sp" 
android:textColor="#fff" 
android:onClick-"login back" 
android:background="@drawable/title_btn_back"/> 


<TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout centerInParent-"true" 
android:textSize-"20sp" 
android:textStyle="bold" 
android:textColor="#ffffft" 
android:text=" 登 录 "/> 
</RelativeLayout> 
<EditText 
android:id="(@+id/login user edit" 
android:layout width-"fill parent" 


android:layout height-"wrap content" 


android:layout_below="@-+id/login top layout" 

android:textColor="#000" 

android:textSize="15sp" 

android:layout_marginTop="25dp" 

android:layout_marginLeft="20dp" 

android:layout_marginRight="20dp" 

android:singleLine="true" 
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android:background="(@drawable/login editbox" 

android:hint-"QQ 号 / 微 信 号 /手机 号 (请 输入 buaa) "> 
<EditText 

android:id="@+id/login passwd edit" 

android:layout_width="fill_parent" 


android:layout_height="wrap_content" 
android:layout_below="@+id/login_user_edit" 
android:textColor="#000" 
android:textSize="15sp" 
android:layout_marginTop="25dp" 
android:layout_marginLeft="20dp" 
android:layout_marginRight="20dp" 
android:background="@drawable/login_editbox" 
android:password="true" 
android:singleLine="true" 
android:hin 全 "密码 (请 输入 123)"/> 
<RelativeLayout 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:layout_marginTop="20dp" 
android:layout_below="@+id/login_passwd_edit"> 
<Button 
android:id="(@+id/forget_passwd" 


ERI 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout marginLeft-"23dp" 
android:layout marginTop-"5dp" 
android:text-" Ass it 24 Mi 
android:textSize-" 16sp" 
android:textColor="#00f" 
android: background="#0000" 
android:onClick-"login pw" /> 

«Button 
android:id-"(g)*id/login login btn" 
android:layout_width="90dp" 
android:layout_height="40dp" 
android:layout_marginRight="20dp" 
android:layout_alignParentRight="true" 
android:text=" 5" 
android:background-"(g)drawable/btn style green" 
android:textColor="#ffffft" 
android:textSize="18sp" 
android:onClick="login_mainweixin"/> 


</RelativeLayout> 
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</RelativeLayout> 


对 应 的 实现 文件 是 loginjava， 有 具体 代码 如 下 。 


package cn.buaa.myweixin; 
import android.net.Uri; 
import android.os.Bundle; 
import android.app.Activity; 
import android.app.AlertDialog; 
import android.content.Intent; 
import android.view.Menu; 
import android.view.View; 
import android.widget.EditText; 
import android.widget. Toast; 
public class Login extends Activity { 
private EditText mUser; // 账号 编辑 
private EditText mPassword; // 2132948: 
@Override 
public void onCreate(Bundle savedInstanceState) { 


H 


H 


super.onCreate(savedInstanceState); 
setContentView(R.layout.login); 

mUser = (EditText)findViewById(R.id.login user edit); 
mPassword = (EditText)findViewById(R.id.login passwd edit); 


j 
public void login mainweixin(View v) { 
AIR CG ein 
if("weixin" equals(mUser. getText().toString()) && "123" equals(mPassword.getText().toString())) 
1 
Intent intent — new Intent(); 
intent.setClass(Login.this,LoadingActivity.class); 
startActivity(intent); 
j 
ILICE RU 3 
else if("".equals(mUser.getText().toString()) || "".equals(mPassword.getText().toString())) 
1 


new AlertDialog.Builder(Login.this) 
.setIcon(getResources().getDrawable(R.drawable.login error icon)) 
.setTitle(" 登 录 错 误 ") 
.SetMessage(" 微 信 账 号 或 者 密码 不 能 为 室 ， 请 输入 后 再 登录 ! ") 
.create().show(); 


} 
else { 
new AlertDialog.Builder(Login.this) 
.setIcon(getResources().getDrawable(R.drawable.login error icon)) 


.setTitle(" 登 录 失 败 ") 
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.SetMessage(" 微 信 账 号 或 者 密码 不 正确 ， 请 检查 后 


.create().show(); 


Iech 


EIMA! ") 


} 
/标题 栏 返 回 按钮 
public void login back(View v) { 
this.finish(); 
} 
/忘记 密码 按钮 
public void login pw(View v) ( 


D 


Uri uri = Uri.parse("http://3g.qq.com"); 
Intent intent = new Intent(Intent ACTION VIEW, uri); 
startActivity(intent); 
} 
} 


登录 成 功 后 调用 文件 Loading Activity,java 进入 系统 主 界面 ， 此 文件 的 实现 代码 如 下 。 


package cn.buaa.myweixin; 

import android.os.Bundle; 

import android.os.Handler; 

import android.app.Activity; 

import android.content.Intent; 

import android.view.Menu; 

import android.view. WindowManager; 

import android.widget. Toast; 

public class LoadingActivity extends Activity { 


@Override 

public void onCreate(Bundle savedInstanceState) { 
// TODO Auto-generated method stub 
super.onCreate(savedInstanceState); 
setContentView(R.layout.loading); 


new Handler().postDelayed(new Runnable() { 
public void run(){ 
Intent intent = new Intent (LoadingActivity.this, Whatsnew.class); 
startA ctivity(intent); 
LoadingActivity.this.finish(); 
ToastmakeText(getApplicationContextQ), " X 3 H Jj", Toast. LENGTH SHORT). 
show(); 


}, 200); 
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16.3.4 发 送信 息 界 面 
为 了 达到 在 线 交 流 目 的 ， 系 统 提供 了 发 送信 息 界面 ， 此 界面 和 QQ 聊天 界面 类 似 ， 呢 狗 
狗 调用 输入 法 输入 文本 信息 。 具 体 UI 界面 如 图 16-6 所 示 。 
E] Palette v | 回国 | E3 G3 - | [i El &&ajaa 


i> Form Tidgets 


E 


Large Medium 


CheckBox 


C Text Fields 

© Layouts 

C Composite 

C Images & Media 
© Time & Date 


© Transitions 


C Advanced 


Custom &...ary Views 


图 16-6 发 送信 息 界 面 
发 送信 息 界面 的 布局 文件 是 chat_xiaohei.xml， 有 具体 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
android:background-"(g)drawable/chat bg default" > 
<RelativeLayout 
android:id="@+id/rl_layout" 
android:layout_width="fill_parent" 
android:layout_height="45dp" 
android:background="(@drawable/title_bar" 
android:gravity="center_vertical" > 
<Button 
android:id="(@+id/btn_back" 
android:layout_width="70dp" 
android:layout_height="wrap_content" 
android:layout_centerVertical="true" 
android:text="i& [n|" 
android:textSize="26sp" 
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android:textColor="#fff" 

android:onClick="chat_back" 

android:background="(@drawable/title_btn_back"/> 
<TextView 


android:layout width-"wrap content" 


android:layout height-" 
android:text="/)\ D 
android:layout_centerInParent="true" 
android:textSize="20sp" 
android:textColor="#ffffft" /> 
<ImageButton 
android:id="@-+id/right_btn" 
android:layout_width="67dp" 


wrap content" 


android:layout height-"wrap content" 
android:layout alignParentRight-"true" 
android:layout centerVertical-"true" 
android:layout marginRight-"5dp" 
android:src-"(g)drawable/mm title bn contact normal" 
android:background-"(g)drawable/title btn right" /> 
</RelativeLayout> 
<RelativeLayout 
android:id="@-+id/rl_bottom" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:layout_alignParentBottom="true" 
android:background="@drawable/chat_footer_bg" > 
<Button 
android:id="(@+id/btn_send" 
android:layout_width="60dp" 
android:layout_height="40dp" 
android:layout_alignParentRight="true" 
android:layout_marginRight="10dp" 
android:layout_centerVertical="true" 
android:text=" 发 送 " 
android:background-"(g)drawable/chat send btn" /> 
<EditText 
android:id="(@+id/et_ sendmessage" 
android:layout_width="fill_parent" 
android:layout_height="40dp" 
android:layout_toLeftOf="@id/btn_send" 
android:layout_marginLeft="10dp" 
android:layout_marginRight="10dp" 
android:background-"(g)drawable/login edit normal" 
android:layout_centerVertical="true" 
android:singleLine="true" 
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android:textSize="18sp"/> 
</RelativeLayout> 
<ListView 
android:id="@+id/listview" 
android:layout_below="@id/rl_layout" 
android:layout_above="@id/rl_bottom" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:divider="(@null" 
android:dividerHeight="5dp" 
android:stackFromBottom="true" 
android:scrollbarStyle="outsideOverlay" 
android:cacheColorHint="#0000"/> 
</RelativeLayout> 


对 应 的 实现 文件 是 ChatActivityjava， 有 具体 代码 如 下 。 


package cn.buaa.myweixin; 


import java.util. Array List; 
import java.util.Calendar; 
import java.util.List; 
import android.app.Activity; 
import android.content. Intent; 
import android.graphics.drawable.LevelListDrawable; 
import android.os.Bundle; 
import android.text.Editable; 
import android.view. View; 
import android.view. View.OnClickListener; 
import android.view. WindowManager; 
import android.widget.Button; 
import android.widget.EditText; 
import android.widget.ListView; 
public class ChatActivity extends Activity implements OnClickListener { 

private Button mBtnSend; 

private Button mBtnBack; 

private Edit Text mEditTextContent; 

private ListView mListView; 

private ChatMsgViewA dapter mAdapter; 

private List<ChatMsgEntity> mDataArrays = new ArrayList<ChatMsgEntity>(); 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.chat xiaohei); 

/启动 Activity 时 不 自动 弹出 软 键盘 
getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT INPUT STATE ` 
ALWAYS HIDDEN); 


~ 
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initView(); 
initData(); 
} 
public void initView() 
{ 
mListView = (ListView) find ViewByld(R.1d.listview); 
mBtnSend = (Button) findViewById(R.id.btn send); 
mBtnSend.setOnClickListener(this); 
mBtnBack = (Button) findViewById(R.id.btn back); 
mBtnBack.setOnClickListener(this); 
mEditTextContent = (EditText) findViewByld(R.id.et_sendmessage); 
} 
private String[]msgArray = new String[]{" 有 大 ", "有 ! ? "y "我 也 有 ", "HS ENE", 
" 打 啊 ! 你 放大 啊 " "你 不 ? 留 人 头 那 ! 。"， 
2 


private String[]dataArray = new String[] ("2012-09-01 18:00", "2012-09-01 18:10", 
"2012-09-01 18:11", "2012-09-01 18:20", 
"2012-09-01 18:30", "2012-09-01 18:35", 
"2012-09-01 18:40", "2012-09-01 18:50"}; 
private final static int COUNT = 8; 
public void initData() 
{ 
for(int i = 0; i < COUNT; i++) 
{ 
ChatMsgEntity entity = new ChatMsgEntity(); 
entity.setDate(dataArray[i]); 
if i % 2 ==0) 
{ 


entity.set(Name("/}\ 54"); 

entity.setMsgType(true); 
yelse { 

entity.setName("A Dm: 

entity.setMsgType(false); 


} 


entity.setText(msgArray[i]); 
mDataArrays.add(entity); 
j 
mAdapter = new ChatMsgViewAdapter(this, mDataArrays); 
mListView.setAdapter(mA dapter); 
} 
public void onClick(View v) { 
// TODO Auto-generated method stub 
switch(v.getId()) 
1 
case R.id.btn send: 
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Send(); 
break; 

case R.id.btn_back: 
finish(); 
break; 


j 
private void send() 
1 
String contString — mEditTextContent.getText().toString(); 
if (contString.length() > 0) 
1 
ChatMsgEntity entity = new ChatMsgEntity(); 
entity.setDate(getDate()); 
entity.setName(" A 5"); 
entity.setMsgType(false); 
entity.setText(contString); 
mDataArrays.add(entity); 
mA dapter.notify DataSetChanged(); 
mkEditTextContent.setText(""); 
mListView.setSelection(mListView.getCount() - 1); 


j 
private String getDate() { 
Calendar c = Calendar. getInstance(); 
String year = String. valueOf(c.get(Calendar. YEAR)); 
String month = String.valueOf(c. get(Calendar. MONTH)); 
String day = String. valueOf(c.get(Calendar. DAY OF MONTH) + 1); 
String hour = String. valueOf(c.get(Calendar. HOUR OF DAY)); 
String mins = String. valueOf(c.get(Calendar.MINUTE)); 
StringBuffer sbBuffer = new StringBuffer(); 
sbBuffer.append(year + "-" + month + "-" + day + " " + hour + ":" + mins); 
return sbBuffer.toString(); 
} 
public void head_xiaohei(View v) { // 标 题 栏 返回 按钮 
Intent intent = new Intent (ChatActivity.this,InfoXiaohei.class); 
startActivity(intent); 


16.3.9 摇 一 摇 界 面 


“ 摇 一 播 ” 是 微 信 的 特色 功能 ， 通 过 播 动 手机 的 方式 可 以 实现 一 个 操作 功能 ， 例 如 发 送 一 
幅 图 片 ， 查 找到 一 个 好 友 等 。 具 体 UI 界面 如 图 16-7 所 示 。 
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C Advanced 


Custos &...ary Views 
FE) Graphical Layout | 三 | shake, activi ty. xml | 
图 16-7 摇 一 摇 设 计 和 界面 
摇 一 摇 设 计 界 面 的 布局 文件 是 shake_activity.xml， 具 体 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:orientation-" vertical" 
android:background="#1 11" 
«RelativeLayout 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layout centerInParent-"true" > 
<ImageView 
android:id="(@+id/shakeBg" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_centerInParent="true" 
android:src="(@drawable/shakehideimg man2" /> 
<LinearLayout 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:layout centerInParent-"true" 


android:orientation-'" vertical" > 


<RelativeLayout 
android:id="@-+id/shakeImgUp" 
android:layout_width="fill_parent" 
android:layout_height="190dp" 
android: background="#1 11"> 
<ImageView 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentBottom-"true" 
android:layout centerHorizontal-"true" 
android:src-"(g)rdrawable/shake logo up" /> 
</RelativeLayout> 
<RelativeLayout 
android:id="@+id/shakelmgDown" 
android:layout_width="fill_parent" 
android:layout_height="190dp" 
android: background="#1 11"> 
<ImageView 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout centerHorizontal-"true" 
android:src-"(g)drawable/shake logo down" /> 
</RelativeLayout> 
</LinearLayout> 
</RelativeLayout> 
<RelativeLayout 
android:id="(@+id/shake_title_bar" 
android:layout width-"fill parent" 
android:layout height-"45dp" 
android:background-" (g)drawable/title bar" 
android:gravity-"center vertical" > 
«Button 
android:layout width-"70dp" 
android:layout height-"wrap content" 
android:layout center Vertical-"true" 
android:text-" jk [u]' 
android:textSize="26sp" 
android:textColor="#fff" 
android:onClick-"shake activity back" 
android:background-" (g)drawable/title btn back"/> 
«TextView 


android:layout width: 


wrap content" 
android:layout height-" 
android:text=" 摇 一 摇 " 
android:layout_centerInParent="true" 
android:textSize="20sp" 


wrap content" 
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android:textColor="#ffffff" /> 
<ImageButton 
android:layout_width="67dp" 


android:layout height-"wrap content" 
android:layout alignParentRight-"true" 
android:layout centerVertical-"true" 
android:layout marginRight-"5dp" 
android:src-"(g)drawable/mm title btn menu" 
android:background-"(g)drawable/title bm right" 
android:onClick-"linshi"/— 
</RelativeLayout> 
<SlidingDrawer 
android:id="@+id/slidingDrawer1" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:content="(@+id/content" 
android:handle="(@+id/handle" > 


<Button 
android:id="(@+id/handle" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:background-"(g)drawable/shake report dragger up" /> 
<LinearLayout 
android:id="(@+id/content" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="#f9f9f0" > 
<ImageView 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:scaleType="fitX Y" 
android:src-"(g)drawable/shake line up" /> 
</LinearLayout> 
</SlidingDrawer> 
</RelativeLayout> 


对 应 的 实现 文件 是 ShakeActivityjava， 有 具体 代码 如 下 。 


public class ShakeActivity extends Activity { 
ShakeListener mShakeListener = null; 
Vibrator mVibrator; 
private RelativeLayout mImgUp; 
private RelativeLayout mImgDn; 
private RelativeLayout mTitle; 
private SlidingDrawer mDrawer; 
private Button mDrawerBtn; 
@Override 
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public void onCreate(Bundle savedInstanceState) { 
// TODO Auto-generated method stub 
super.onCreate(savedInstanceState); 
setContentView(R.layout.shake activity); 
mVibrator = (Vibrator)getApplication().getSystemService(VIBRATOR. SERVICE); 
mlmgUp = (RelativeLayout) findViewById(R.id.shakeImgUp); 
mlImgDn = (RelativeLayout) findViewById(R.id.shakelmgDown); 
mTitle = (RelativeLayout) find ViewById(R.id.shake title bar); 
mDrawer = (SlidingDrawer) find ViewById(R.id.slidingDrawerl); 
mDrawerBtn = (Button) find ViewById(R.id.handle); 
mDrawer.setOnDrawerOpenListener(new OnDrawerOpenListener() 
{ public void onDrawerOpened() 

1 
mDrawerBtn.setBackgroundDrawable(getResources().getDrawable(R.drawable.shake report drag 
ger down)); 

TranslateAnimation titleup m new 
TranslateAnimation(Animation.RELATIVE TO SELF,0f,Animation. RELATIVE TO SELF,0f, Animation. RELAT 
IVE_TO_SELF,0f, Animation. RELATIVE TO_SELF,-1.0f); 

titleup.setDuration(200); 

titleup.setFillA fter(true); 

mTitle.startAnimation(titleup); 


= 一 


Dk 
/* 设 定 SlidingDrawer 被 关闭 的 事件 处 理 */ 
mDrawer.setOnDrawerCloseListener(new OnDrawerCloseListener() 
{ public void onDrawerClosed() 
{ 
mDrawerBtn.setBackgroundDrawable(getResources().getDrawable(R.drawable.shake_report_drag 
ger_up)); 


TranslateAnimation titledn = new 
TranslateAnimation(Animation.RELATIVE TO SELF,0f,Animation RELATIVE TO_SELF,Of, Animation. RELAT 
IVE TO SELF.-1.0f,Animation.RELATIVE TO SELF,0f); 

titledn.setDuration(200); 

titledn.setFillA fter(false); 

mTitle.startAnimation(titledn); 


= 一 


Di 
mShakeListener = new ShakeListener(this); 
mShakeListener.setOnShakeListener(new OnShakeListener() { 
public void onShake() { 
startAnim(); = //FP aad FFE 
mShakeListener.stop(); 
startVibrato(); /开始 振动 
new Handler().postDelayed(new Runnable() { 


public void run(){ 
Toast mtoast; 
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mtoast = Toast.makeText(getApplicationContext(), 


再 试 一 次 吧 ! ", 10); 


个 参数 是 


raat 
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limi 


， 和 暂时 没有 找到 \n 在 同一 时 刻 摇 一 摇 的 人 。\n 


mtoast.show(); 


mVibrator.cancel(); 
mShakeListener.start(); 


j 
}, 2000); 


Di 
j 
//5 SC hg 
public void startAnim () { 


AnimationSet animup = new AnimationSet(true); 


TranslateAnimation mytranslateanimup0 = new TranslateAnimation 


(Animation.RELATIVE TO SELF,0fj,Animation.RELATIVE TO SELF,Of,Animation. 


RELATIVE TO SELF,0f,Animation.RELATIVE TO SELFE,-0.5f); 


mytranslateanimup0.setDuration(1000); 


TranslateAnimation mytranslateanimupl = new TranslateAnimation 


(Animation.RELATIVE TO SELF,0f,Animation.RELATIVE TO SELF,Of,Animation. 


RELATIVE TO SELF,0f,Animation RELATIVE TO SELF,-0.5f); 


mytranslateanimupl .setDuration(1000); 
mytranslateanimupl .setStartOffset( 1000); 


animup.addAnimation(mytranslateanimup0); 


animup.addAnimation(mytranslateanimup1); 


mlImgUp.startAnimation(animup); 


AnimationSet animdn — new AnimationSet(true); 


TranslateAnimation mytranslateanimdn0 = new TranslateAnimation 


(Animation.RELATIVE TO SELF,0fj,Animation.RELATIVE TO SELF,Of,Animation. 


RELATIVE TO SELF,0fj,Animation.RELATIVE TO SELF,-0.5f); 


mytranslateanimdn0.setDuration(1000); 


TranslateAnimation mytranslateanimdn1 = new TranslateAnimation 


(Animation.RELATIVE TO SELF,0f,Animation. RELATIVE TO SELF,Of,Animation. 


RELATIVE TO SELF,0f,Animation RELATIVE TO SELF,-0.5f); 


mytranslateanimdnl .setDuration(1000); 
mytranslateanimdnl .setStartOffset( 1000); 


animdn.addAnimation(mytranslateanimdn0); 


animdn.addAnimation(mytranslateanimdn1); 


mImgDn.startAnimation(animdn); 
} 
// 定 义 振动 
public void startVibrato(){ 


mVibrator.vibrate( new long[]{500,200,500,200}, -1); /第 一 个 【{)} 里 面 是 
EU, -1 为 不 重复 ， 非 -1 为 从 pattern 的 指定 下 标 开 始 重 复 


} 
public void shake_activity_back(View v) { 


/标题 栏 返 回 按钮 


zu 


"0 


奏 数 组 ， 


A 


Ay 


第 16 章 ”开发 移动 微 信 系统 


this.finish(); 
} 
public void linshi(View v) { /标题 栏 
startAnim(); 
} 
@Override 
protected void onDestroy() { 
super.onDestroy(); 
if (mShakeListener != null) { 
mShakeListener.stop(); 


j 


iy 


文件 ShakeListenerjava 的 功能 是 通过 重力 感应 器 实现 重力 监听 ， 这 是 实现 “ 播 一 摇 ” 功 
能 的 基础 。 文 件 ShakeListenerjava 的 具体 实现 代码 如 下 。 


package cn.buaa.myweixin; 

import android.content.Context; 

import android.hardware.Sensor; 

import android.hardware.SensorEvent; 

import android.hardware.SensorEventListener; 
import android. hardware.SensorManager; 


import android.util.Log; 

/* * 
* 一 个 检测 手机 摇晃 的 监听 器 
s 


public class ShakeListener implements SensorEventListener { 
/ 速度 闵 值 ， 当 摇晃 速度 达到 该 值 后 产生 作用 
private static final int SPEED SHRESHOLD = 3000; 
/ 两 次 检测 的 时 间 间 隔 
private static final int UPTATE INTERVAL TIME = 70; 
/ 传感器 管理 器 
private SensorManager sensorManager; 
/ 传感器 
private Sensor sensor; 
// 重力 感应 监听 器 
private OnShakeListener onShakeListener; 
M ETE 
private Context mContext; 
/ 手机 上 一 个 位 置 时 重力 感应 坐标 
private float lastX; 


private float lastY; 
private float lastZ; 
/ 上 次 检测 时 间 
private long lastUpdateTime; 
/ 构造 器 
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public ShakeListener(Context c) { 
/ 获得 监 昕 对 象 
mContext = c; 
start(); 
j 
/ 开始 
public void start() { 
/ 获得 传感器 管理 器 
sensorManager = (SensorManager) mContext 
.getSystemService(Context. SENSOR SERVICE); 
if (sensorManager != null) { 
/ 获得 重力 传感器 
sensor = sensorManager.getDefaultSensor(Sensor. TYPE ACCELEROMETER); 


} 
/ 注册 
if (sensor != null) { 
sensorManager.registerListener(this, sensor, 
SensorManager.SENSOR. DELAY GAME); 


j 

/ 停止 检测 

public void stop() { 
sensorManager.unregisterListener(this); 

} 

/ 设置 重力 感应 监听 器 

public void setOnShakeListener(OnShakeListener listener) { 
onShakeListener = listener; 


} 

/ 重力 感应 器 感应 获得 变化 数据 

public void onSensorChanged(SensorEvent event) { 
/ 现在 检测 时 间 
long currentUpdateTime = System.currentTimeMillis(); 
A 两 次 检测 的 时 间 间 隔 
long timeInterval = currentUpdateTime - lastUpdateTime; 
/ 判断 是 否 达 到 了 检测 时 间 间 隔 
if (timeInterval < UPTATE INTERVAL TIME) 

return; 

/ 现在 的 时 间 变 成 last 时 间 

lastUpdateTime = currentUpdateTime; 

/ 获得 xy,z 坐标 

float x = event.values[0]; 


mw 


float y = event.values[1]; 
float z = event.values[2]; 
/ 获得 xy,z 的 变化 值 
float deltaX = x - lastX; 
float deltaY = y - lastY; 
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第 四 篇 ”综合 实战 篇 
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交友 是 人 们 为 了 摆脱 自己 单身 的 生活 ， 而 去 结交 认识 他 人 的 过 程 。 交 友 的 类 型 可 以 是 女 
朋友 或 者 男 朋友 ， 也 可 以 是 普通 朋友 。 在 本 音 的 内 容 中 ， 将 详细 讲解 在 Android 系统 中 开发 
一 款 仿 陌 陌 系统 的 交友 软件 ， 为 读者 掌握 Android 应 用 开发 的 核心 技术 打下 基础 。 


17.1 BERENA 


陌 陌 是 一 款 基 于 地 理 位 置 的 移动 社交 工具 ， 可 以 通过 陌 陌 认识 周围 范围 内 的 陌生 人 ， 碍 
看 对 方 的 个 人 信息 和 位 置 ， 免 费 发 送 短信 、 语 音 、 照 片 以 及 精准 的 地 理 位 置 。 陌 陌 专注 于 移 
动 互联 网 ， 专 注 于 移动 社交 ， 专 注 于 社交 模式 探索 并 满足 人 们 的 社交 愿望 。 公 司 于 2011 年 3 
HT. 


17.1.1 陌 陌 发 展现 状 


陌 陌 是 陌 陌 科技 开发 的 首 个 基于 iPhone 和 Android. Windows Phone 的 手机 应 用 ， 有 别 于 
微 信 、 微 博 、QQ、YY、MSN、 和 群 群 、 遇 见 等 手机 社交 软件 。 通 过 陌 陌 可 以 提供 真实 的 位 置 
信息 ， 解 决 了 以 往 社交 软件 过 于 虚幻 ， 缺 乏 真实 的 线 下 互动 的 问题 。2011 年 8 月 3 日 ， 陌 陌 
iOS 版 正式 上 线 。 

2013 年 4 月 24 日 ， 在 由 艾 瑞 咨询 举办 的 2012—2013 中 国 移动 互联 网 应 用 评选 活动 上 ， 
陌 陌 获 得 中 国 移动 互联 网 应 用 年 度 最 具 创新 力 大 奖 。13 年 4 月 15 日 ， 陌 陌 3.4 版 本 上 线 。 新 
增 附 近 群 组 搜索 ， 创 建 好 友 间 多 人 对 话 ， 微 博 好 友 推 荐 功能 。 

2014 年 12 月 12 日 ， 陌 陌 科 技 登陆 纳 斯 达 克 。 


171.2 陌 陌 特点 介绍 

C1) 社交 模式 

根据 GPS 搜寻 和 定位 身边 的 陌生 人 和 和 群 组 ， 高 效 快捷 的 建立 联系 ， 节 省 沟通 的 距离 
成 本 。 

(2) 免费 传递 


= 


可 以 方便 的 通过 陌 陌 免费 发 送 短信 、 语 音 、 照 片 以 及 精准 的 地 理 位 置 ， 与 他 人 进行 各 种 
互动 。 
(3) 递送 提示 


即时 了 解 信 息 送 达 的 状态 ,“ 送 达 、 已 读 ” 等 提示 能 让 用 户 及 时 掌握 信息 是 否 被 对 
方 看 到 。 
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(4) 个 人 资料 

可 以 在 资料 页 存放 八 张 照片 ， 以 及 签名 、 职 业 、 爱 好 等 信息 ， 以 增进 其 他 人 对 用 户 

的 了 解 。 
(5) 场景 表情 
表情 商店 提供 丰富 的 表情 ， 让 聊天 不 再 单调 , 更 加 的 生动 活泼 ,符合 移动 社交 的 聊天 


Së 


3J 

(6) 会 员 服 务 

可 享受 陌 陌 不 断 推出 的 各 种 增值 及 专属 服务 ， 包 括 基 础 会 员 服 务 、 上 限 提升 服务 、 表 情 
商店 服务 等 。 

(7) 隐私 保护 

可 以 随时 把 厌恶 的 人 拉 入 黑 
模式 。 

(D 平台 支持 

全 面 支持 多 种 iOS 设备 ， 以 及 Android 2.3 及 以 上 版 本 的 手机 ， 支 持 各 种 网 络 接 入 方式 。 


17.2 ”实现 系统 欢迎 界面 


运行 本 防 防 系统 后 , 将 首先 显示 一 个 系统 欢迎 界面 ， 以 一 副 图 片 作 为 背景 ,下 方 显示 “ 注 
册 ” 和 “登录 ”按钮 ， 如 图 17-1 所 示 。 


: 


Po JAAP DA ATA RITARIT, JF AS REESE 


^ 
DH B 
0.84km 1.02km 1.34km 1.88km 2.51 


图 17-1 系统 欢迎 界面 
解 系统 欢迎 界面 的 具体 实现 过 程 。 


SS 
= 


TEACH rh, Jä 
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17.21 欢迎 界面 布局 


本 系统 欢迎 界面 Activity 是 .activity.WelcomeActivity， 对 应 界面 布局 文人 
日 在 界面 下 方 通过 两 个 Button f| 


welcome.xml, 功能 是 通过 ImageView 控件 显示 背景 图 片 ， 
显示 “注册 ”和 “登录 ”按钮 ， 具 体 实现 代码 如 下 。 


F 是 activity_ 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout_width="fill_parent" 
android:layout height-"fill parent" 


android:background-"(g)drawable/pic index background" 


android:orientation-" vertical" > 
«RelativeLayout 
android:layout width-"fill parent" 


android:layout height-"wrap content" 
android:layout alignParentTop-"true" > 
<ImageView 

android:layout width-"wrap content" 


android:layout height-"wrap content" 


android:scaleType="center" 
android:src-"(g)drawable/pic index logo" /> 
<ImageView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentRight-"true" 
android:layout alignParentTop-"true" 


android:scaleType="center" 
android:visibility="gone" /> 

</RelativeLayout> 

<Image View 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentBottom-"true" 
android:layout centerHorizontal-"true" 
android:scaleType="center" 
android:src="(@drawable/pic_index_copyright" /> 

<LinearLayout 
android:id="(@+id/welcome_linear_ctrlbar" 
android:layout_width="fill_parent" 
android:layout_height="wrap_ content" 


android:layout_alignParentBottom="true" 


android:background-"(g)drawable/bg welcome ctrlbar" 


android:gravity-"center horizontal|bottom" 
android:orientation-" vertical" 
android:paddingBottom-" 1 5dip" 


android:paddingLeft-"5dip" 
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android:paddingRight="5dip" 

android:paddingTop="13dip" > 

<LinearLayout 
android:id="@+id/welcome linear avatars" 
android:layout width-"fill parent" 


android:layout height-"wrap content" 
android:gravity="center" 
android:orientation="horizontal" > 
<include 


android:id-"(a)-id/welcome include member avatar block0" 


android:layout weight-" 1" 
layout-"(glayout/nclude welcome item" /> 

«include 
android:id-"(g)id/welcome include member avatar block)? 
android:layout weight-" 1" 
layout-"(gayout/nclude welcome item" /> 


«include 


android:id-"(g)id/welcome include member avatar block2" 


android:layout weight-" 1" 
layout-"(glayout/nclude welcome item" /> 

«include 
android:id-"(g)*id/welcome include member avatar block3" 
android:layout weight-" 1" 
layout-"(glayout/nclude welcome item" /> 


«include 


android:id-"(g)*id/welcome include member avatar block4" 


android:layout weight-" 1" 
layout-"(glayout/nclude welcome item" /> 

«include 
android:id-"(a)-id/welcome include member avatar block5" 
android:layout weight-" 1" 
layout-"(gayout/nclude welcome item" /> 


</LinearLayout> 
<LinearLayout 


android:layout width-"wrap content" 


android:layout height-"wrap content" 


android:gravity="center" 
android:orientation="horizontal" 
android:visibility="invisible" > 
<ImageView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 


android:layout_gravity="center" 


android:src="(@drawable/ic_index_totaluser" /> 
<com.immomo.momo.android.view.HandyTextView 
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android:id="@+id/welcome_htv_usercount" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_gravity="bottom" 
android:layout marginLeft-"5dip" 
android:layout marginRight-"5dip" 
android:text="0" 
android:textColor="#FFFFFFFEF" 
android:textSize="18sp" /> 
<com.immomo.momo.android.view. HandyTextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout gravity-" bottom" 
android:text=" 位 用 户 在 你 身边 " 
android:textColor="#FFFFFFFF" 
android:textSize="13sp" 
android:textStyle="bold" /> 
</LinearLayout> 


<LinearLayout 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:gravity="center" 
android:orientation="horizontal" > 
<Button 
android:id="@+id/welcome_btn_register" 
android:layout_width="100dip" 
android:layout_height="40dip" 
android:layout margin-"5dip" 
android:background-"(g)drawable/btn default blue" 
android:text=" 注 册 " 
android:textColor="#FFFFFFFF" /> 
<Button 
android:id-"(a)-id/welcome bm login" 
android:layout_width="100dip" 
android:layout_height="40dip" 
android:layout margin-"5dip" 
android:background-"(g)drawable/btn default white" 
android:text-" 35i" 
android:textColor="#£f465579" /> 
<ImageButton 
android:id="@+id/welcome_ibtn_about" 
android:layout width-"wrap content" 
android:layout_height="40dip" 
android:layout margin-"5dip" 


android:layout_marginLeft="10dip" 
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android:background="@drawable/btn_default_white" 


—" 


android:src="@drawable/ic_welcome_about_normal" /> 


</LinearLayout> 
</LinearLayout> 


17.2.2 ”欢迎 界面 Mtivity 

欢迎 界面 Activity 的 实现 文件 是 WelcomeActivityjava， 功 能 是 监听 用 户 单 击 屏幕 操作 ， 
根据 用 户 单 击 的 图 标 或 按钮 跳 转 到 注册 界面 、 登 录 界 面 或 帮助 界面 。 文 件 WeleomeActivity.java 
的 具体 实现 代码 如 下 。 


public class WelcomeActivity extends BaseActivity implements OnClickListener { 
private LinearLayout mLinearCtrlbar; 
private LinearLayout mLinearAvatars; 
private Button mBtnRegister; 
private Button mBtnLogin; 
private ImageButton mlbtnA bout; 
private View[] mMemberBlocks; 
private String[] mAvatars = new String[] { "welcome_0", "welcome_1", 
"welcome 2", "welcome 3", "welcome 4", "welcome 5" }; 
private String[] mDistances = new String[] { "0.84km", "1.02km", "1.34km", 
"].88km", "2.50km", "2.78km" }; 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
// TODO Auto-generated method stub 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity welcome); 


initViews(); 
initEvents(); 
initA vatarsItem(); 
showWelcomeAnimation(); 
} 
@Override 


protected void initViews() { 
mLinearCtrlbar = (LinearLayout) find ViewByld(R.id.welcome_linear_ctrlbar); 
mLinearA vatars = (LinearLayout) findViewById(R.id.welcome linear avatars); 
mBtnRegister = (Button) findViewByld(R.id.welcome_btn_register); 
mBtnLogin = (Button) findViewByld(R.id.welcome_btn_login); 
mlbtnA bout = (ImageButton) findViewById(R.id.welcome ibtn about); 

} 

@Override 

protected void initEvents() { 
mBtnRegister.setOnClickListener(this); 
mBtnLogin.setOnClickListener(this); 
mlbtnA bout.setOnClickListener(this); 

} 


private void initAvatarsItem() { 
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} 


initMemberBlocks(); 
for (int i = 0; i < mMemberBlocks.length; i++) { 

((ImageView) mMemberBlocks[i] 
.findViewById(R.id.welcome item iv avatar)) 
.setimageBitmap(mAppplication.getA vatar(mA vatars[1])); 

((HandyTextView) mMemberBlocks[i] 
.findViewById(R.id.welcome item htv distance)) 
.setText(mDistances[1]); 


private void initMemberBlocks() { 


j 


mMemberBlocks = new View[6]; 
MemberBlocks[0] = findViewById(R.id.welcome include member avatar block0); 


m [ 

mMemberBlocks| 1] = findViewById(R.id.welcome include member avatar blockl); 
mMemberBlocks[2] = findViewById(R.id.welcome include member avatar block2); 
m [ 
m [ 


MemberBlocks[3] = findViewById(R.id.welcome include member avatar block3); 
MemberBlocks[4] = findViewById(R.id.welcome include member avatar block4); 
mMemberBlocks[5] = findViewById(R.id.welcome include member avatar block5); 


int margin = (int) TypedValue.applyDimension( 
TypedValue.COMPLEX UNIT DIP, 4, getResources() 
.getDisplayMetrics()); 
int widthAndHeight = (mScreenWidth - margin * 12) / 6; 
for (int i = 0; i < mMemberBlocks.length; i++) { 
ViewGroup.LayoutParams params = mMemberBlocks[i].find ViewByld( 
R.id.welcome item iv avatar).getLayoutParams(); 
params.width — widthAndHeight; 
params.height — widthAndHeight; 
mMemberBlocks[i].find ViewById(R.id.welcome item iv avatar) 
.setLayoutParams(params); 


j 


mLinearA vatars.invalidate(); 


private void showWelcomeAnimation() 1 
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Animation animation — AnimationUtils.loadAnimation( 
WelcomeActivity.this, R.anim.welcome ctrlbar slideup); 
animation.setAnimationListener(new AnimationListener() { 
@Override 
public void onAnimationStart(Animation animation) { 
mLinearA vatars.setVisibility(View.GONE); 
} 
@Override 
public void onAnimationRepeat(Animation animation) { 


j 


@Override 
public void onAnimationEnd(Animation animation) { 
new Handler().postDelayed(new Runnable() { 
@Override 
public void run() { 
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mLinearAvatars.setVisibility(View. VISIBLE); 


} 
}, 800); 
} 
Di 
mLinearCtrlbar.startAnimation(animation); 
} 
@Override 


public void onClick(View v) { 

switch (v.getId()) { 

case R.id.welcome btn register: 
startActivity(RegisterA ctivity.class); 
break; 

case R.id.welcome btn login: 
startActivity(LoginActivity.class); 
break; 

case R.id.welcome ibtn about: 
startActivity(AboutTabsActivity.class); 
break; 


173 ”实现 系统 注册 界面 


当 在 欢迎 界面 单 击 “ 注 册 ” 按 钮 后 会 跳 转 到 系统 注册 界面 ， 如 图 17-2 所 示 。 


| 


Q imnes 


+86 输入 手机 号 码 
注册 即 表示 你 同意 耳 陌 用 户 协议 。 违 反 协议 的 用 户 
可 能 限制 使 用 ， 请 查看 协议 并 约束 行为 


图 17-2 系统 注册 界面 
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TEA TR 


的 内 容 中 ， 将 详细 讲解 系统 注册 界面 的 具体 实现 过 程 。 
17.3.1 注册 界面 布局 


=> 


D 


在 系统 注册 界面 中 的 布局 文件 是 activity registerxml， 功 能 是 


输入 11 位 手 
体 实现 代码 妇 


机 号 码 ， 在 下 方 显示 “返回 ”和 “下 一 步 ” 按 钮 。 文 件 activity register.xml 的 具 


HF 


<?xml version="1.0" encoding="utf-8"?> 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 


498 E 


android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:background-"(g)color/background normal" 


android:orientation-"vertical" > 
«include 
android:id="@-+id/reg_header" 
layout-"(glayout/include header" /> 
«LinearLayout 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layout below-"(g)-id/reg header" 
android:orientation-" vertical" > 
<LinearLayout 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:layout weight-"1" 
android:orientation-" vertical" > 
<ViewFlipper 
android:id-"(a)-id/reg vf viewflipper" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:flipInterval-" 1000" 
android:persistentDrawingCache="animation" > 
<include 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


layout-"(glayout/nclude register phone" /> 
«include 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
layout-"(a)layout/include register verify" /> 
«include 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


layout-"(gayout/include register setpwd" /> 


EED SERRE 


供用 户 
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<include 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
layout-"(ag)layout/include register baseinfo" /> 
«include 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
layout-"(a)layout/include register birthday" /> 
«include 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
layout-"(g)layout/include register photo" /> 
</ViewFlipper> 
</LinearLayout> 
<LinearLayout 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:background-"(g)drawable/bg unlogin bar" 


android:gravity-"center vertical" 
android:orientation-"horizontal" 
android:paddingBottom="4dip" 
android:paddingLeft="8dip" 
android:paddingRight="8dip" 
android:paddingTop="4dip" > 
<Button 
android:id="@-+id/reg_btn_previous" 
android: layout_width=" 
android:layout_height="42dip" 


android:layout_marginRight="9dip" 


wrap content" 


android:layout weight-" 1" 

android:background-" (g)drawable/btn bottombar" 

android: gravity-" center" 

android:textColor-"(g)color/profile bottom text color" 

android:textSize="14sp" /> 
<Button 

android:id="@-+id/reg_btn_next" 

android: layout_width=" 
android:layout_height="42dip" 
android:layout_marginLeft="9dip" 
android:layout_weight="1" 
android:background="(@drawable/btn_bottombar" 
android: gravity="center" 


wrap content" 


android:textColor-"(g)color/profile bottom text color" 
android:textSize="14sp" /> 
</LinearLayout> 
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17.3.2 


</LinearLayout> 
<Image View 


android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:layout_below="@-+id/reg_header" 


android:background="@drawable/bg_topbar_shadow' 


android:focusable="true" /> 


</RelativeLayout> 


注册 界面 Mtivity 


注册 界面 Activity 的 实现 文件 是 RegisterActivity,java， 功 能 是 监听 用 户 单 击 屏幕 操作 ， 模 
输入 的 注册 信息 进行 验证 。 本 系统 设置 的 合法 手机 号 码 是 “12345678901 ”， 
如 果 输 入 其 他 号 码 会 输出 “已 经 注册 的 提示 ”% CM 


据 用 户 在 表单 ! 
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F RegisterActivity.java 的 有 具体 实现 代码 如 下 。 


public class RegisterActivity extends BaseActivity implements OnClickListener, 


onNextActionListener { 

private HeaderLayout mHeaderLayout; 

private ViewFlipper mVfFlipper; 

private Button mBtnPrevious; 

private Button mBtnNext; 

private BaseDialog mBackDialog; 

private RegisterStep mCurrentStep; 

private StepPhone mStepPhone; 

private StepVerify mStepVerify; 

private StepSetPassword mStepSetPassword; 

private StepBaseInfo mStepBaselnfo; 

private StepBirthday mStepBirthday; 

private StepPhoto mStepPhoto; 

private int mCurrentStepIndex = 1; 

@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity register); 


initViews(); 
mCurrentStep = initStep(); 
initEvents(); 
initBackDialog(); 

} 

@Override 


protected void onDestroy() { 
PhotoUtils.deleteImageFile(); 
super.onDestroy(); 

j 

@Override 

protected void init Views() { 
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mHeaderLayout = (HeaderLayout) findViewById(R.id.reg header); 
mHeaderLayout.init(HeaderStyle. TITLE RIGHT TEXT); 
mVfFlipper = (ViewFlipper) findViewById(R.id.reg vf viewflipper); 
mVfFlipper.setDisplayedChild(0); 
mBtnPrevious = (Button) findViewById(R.id.reg bn previous); 
mBtnNext = (Button) findViewByld(R.id.reg btn next); 

} 

@Override 

protected void initEvents() { 
mCurrentStep.setOnNextActionListener(this); 
mBtnPrevious.setOnClickListener(this); 
mBtnNext.setOnClickListener(this); 

} 

@Override 

public void onBackPressed() { 
if (mCurrentStepIndex <= 1) { 


mBackDialog.show(); 
} else { 
doPrevious(); 
} 
} 
@Override 


public void onClick(View arg0) { 
switch (arg0.getId()) { 
case R.id.reg btn previous: 
if (mCurrentStepIndex <= 1) { 
mBackDialog.show(); 
) else { 
doPrevious(); 
} 
break; 
case R.id.reg btn next: 
if (mCurrentStepIndex « 6) ( 
doNext(); 
} else ( 
if (mCurrentStep.validate()) { 
mCurrentStep.doNext(); 


break; 


@Suppress Warnings("deprecation") 

@Override 

protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
super.onActivityResult(requestCode, resultCode, data); 
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switch (requestCode) { 
case PhotoUtils INTENT REQUEST CODE ALBUM: 
if (data == null) { 
return; 
j 
if (resultCode == RESULT OK) { 
if (data.getData()- — null) { 
return; 
} 
if (!FileUtils.isSdcardExist()) { 
showCustomToast("SD 卡 不 可 用 ,请 检查 "); 
return; 
} 
Uri uri = data.getData(); 
String[] proj = { MediaStore.Images.Media.DATA }; 
Cursor cursor = managedQuery(uri, proj, null, null, null); 
if (cursor != null) { 
int column_index = cursor 
.getColumnIndexOrThrow(MediaStore.Images.Media. DAT A); 
if (cursor.getCount() > 0 && cursor.moveToFirst()) { 
String path = cursor.getString(column_index); 
Bitmap bitmap = BitmapFactory.decodeFile(path); 
if (PhotoUtils.bitmapIsLarge(bitmap)) { 
PhotoUtils.cropPhoto(this, this, path); 
} else { 
mStepPhoto.setUserPhoto(bitmap); 


j 
break; 
case PhotoUtils.INTENT REQUEST CODE CAMERA: 
if (resultCode == RESULT OK) { 
String path = mStepPhoto.getTakePicturePath(); 
Bitmap bitmap — BitmapFactory.decodeFile(path); 
if (PhotoUtils.bitmapIsLarge(bitmap)) { 
PhotoUtils.cropPhoto(this, this, path); 
} else { 
mStepPhoto.setUserPhoto(bitmap); 


j 
break; 
case PhotoUtils INTENT REQUEST CODE CROP: 
if (resultCode == RESULT OK) { 
String path — data.getStringExtra("path"); 
if (path != null) { 
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Bitmap bitmap = BitmapFactory.decodeFile(path); 
if (bitmap != null) { 
mStepPhoto.setUserPhoto(bitmap); 


j 
j 
j 
break; 
j 
j 
@Override 
public void next() { 
mCurrentStepIndex++; 


mCurrentStep = initStep(); 
mCurrentStep.setOnNextActionListener(this); 
mV fFlipper.setInAnimation(this, R.anim.push left in); 
mVfFlipper.setOutAnimation(this, R.anim.push left out); 
mVfFlipper.showNext(); 
j 
private RegisterStep initStep() { 
switch (mCurrentStepIndex) { 
case 1: 
if (mStepPhone == null) { 
mStepPhone = new StepPhone(this, mVfFlipper.getChildAt(0)); 


} 


mHeaderLayout.setTitleRightText(" 注 册 新 账号 ", null, "1/6"); 
mBtnPrevious.setText("i& HI"); 

mBtnNext.setText(" F —22"); 

return mStepPhone; 


case 2: 
if (mStepVerify == null) { 
mStepVerify = new StepVerify(this, mVfFlipper.getChildAt(1)); 
} 
mHeaderLayout.setTitleRightText(" 填 写 验 证 码 ", null, "2/6"); 
mBtnPrevious.setText(" 上 一 步 "); 
mBtnNext.setText(" 下 一 步 "); 
return mStepVerify; 
case 3: 
if (mStepSetPassword == null) { 
mStepSetPassword = new StepSetPassword(this, 
mV fFlipper.getChildAt(2)); 
} 
mHeaderLayout.setTitleRightText(" e 4415", null, "3/6"); 
mBtnPrevious.setText(" 上 一 步 "); 
mBtnNext.setText(" 下 一 步 "); 
return mStepSetPassword; 


case 4: 
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if (mStepBaseInfo == null) { 
mStepBaseInfo = new StepBaselInfo(this, mVfFlipper.getChildAt(3)); 
} 
mHeaderLayout.setTitleRightText(" 填 写 基本 资料 ", null, "4/6"); 
mBtnPrevious.setText(" 上 一 步 "); 
mBtnNext.setText(" 下 一 步 "); 
return mStepBaselInfo; 
case 5: 
if (mStepBirthday == null) { 
mStepBirthday = new StepBirthday(this, mVfFlipper.getChildAt(4)); 


j 


mHeaderLayout.setTitleRightText(" 44: HY 4 
mBtnPrevious.setText(" 上 一 步 "); 
mBtnNext.setText(" 下 一 步 "); 
return mStepBirthday; 
case 6: 
if (mStepPhoto == null) { 
mStepPhoto = new StepPhoto(this, mVfFlipper.getChildAt(5)); 


aay 


H", null, "5/6"); 


} 

mHeaderLayout.setTitleRightText("W e 3. f", null, "6/6"); 
mBtnPrevious.setText(". 上 一 步 "); 

mBtnNext.setText(" 注 Wt"); 

return mStepPhoto; 


} 


return null; 


j 


private void doPrevious() ( 
mCurrentStepIndex--; 
mCurrentStep = initStep(); 
mCurrentStep.setOnNextActionListener(this); 
mVfFlipper.setInAnimation(this, R.anim.push right in); 
mVfFlipper.setOutAnimation(this, R.anim.push right out); 
mVfFlipper.showPrevious(); 
} 
private void doNext() { 
if (mCurrentStep.validate()) { 
if (mCurrentStep.isChange()) { 
mCurrentStep.doNext(); 
} else { 


next(); 


j 
private void initBackDialog() { 
mBackDialog = BaseDialog.getDialog(RegisterActivity.this, "提示 ", 


504 HH 


BIS ARIORA K 


"确认 要 放弃 注册 么 ?", "确认 ", new DialogInterface.OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) { 


dialog.dismiss(); 
finish(); 


j 
}, "取消 ", new DialogInterface.OnClickListener() { 


@Override 
public void onClick(DialogInterface dialog, int which) { 


dialog.cancel(); 


D 
mBackDialog.setButtonl Background(R.drawable.btn default popsubmit); 


} 

@Override 

protected void putAsyncTask(AsyncTask<Void, Void, Boolean> asyncTask) { 
super.putAsyncTask(asyncTask); 

} 

@Override 

protected void showCustomToast(String text) { 
super.showCustomT oast(text); 

} 

@Override 

protected void showLoadingDialog(String text) { 
super.showLoadingDialog(text); 

} 

@Override 

protected void dismissLoadingDialog() { 
super.dismissLoadingDialog(); 

} 

protected int getScreenWidth() { 
return mScreen Width; 

} 

protected BaseApplication getBaseApplication() { 
return mApplication; 

} 

protected String getPhoneNumber() { 
if (mStepPhone != null) { 

return mStepPhone.getPhoneNumber(); 

} 


"t. 


return `"; 
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如 果 注 册 手 机 号 合法 ， 则 弹出 输入 验证 码 界面 ， 如 图 17-3 所 示 。 


© 填写 验证 码 


验证 码 已 经 发 送 到 * (+86)12345678901 


重 发 (26) 


总 是 收 不 到 验证 码 ? 


图 17-3 输入 验证 码 界面 


17.3.3 ”输入 验证 码 界面 Activity 

输入 验证 码 界 面 Activity 的 实现 文件 是 StepVerifyjava， 功 能 是 验证 注册 用 户 输入 的 验证 
码 是 否 合法 。 在 本 项 目 中 ， 设 置 的 固定 验证 码 是 “123456”。 文 件 StepVerifyjava 的 具体 实现 
代码 如 下 。 


public class StepVerify extends RegisterStep implements OnClickListener, 
TextWatcher { 
private HandyTextView mHtvPhoneNumber; 
private EditText mEtVerifyCode; 
private Button mBtnResend; 
private HandyTextView mHtvNoCode; 
private static final String PROMPT = "验证 码 已 经 发 送 到 * "; 
private static final String DEFAULT VALIDATE CODE = "123456"; 


private boolean mIsChange = true; 
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private String mVerifyCode; 

private int mReSendTime = 60; 

private BaseDialog mBaseDialog; 

public StepVerify(RegisterActivity activity, View contentRootView) { 
super(activity, contentRootView); 
handler.sendEmptyMessage(0); 

} 

@Override 

public void initViews() { 


mHtvPhoneNumber = (HandyTextView) findViewByld(R.id.reg_verify_htv_phonenumber); 


mHtvPhoneNumber.setText(PROMPT + getPhoneNumber()); 


mEtVerifyCode = (EditText) findViewById(R.id.reg verify et verifycode); 


mBtnResend = (Button) findViewBylId(R.id.reg verify btn resend); 
mBtnResend.setEnabled(false); 
mBtnResend.setText(" :& / (60)"); 


mHtvNoCode = (HandyTextView) findViewById(R.id.reg verify htv nocode); 
TextUtils.addUnderlineText(mContext, mHtvNoCode, 0, mHtvNoCode 


.getText().toString().length()); 
} 
@Override 
public void initEvents() { 
mBtnResend.setOnClickListener(this); 
mHtvNoCode.setOnClickListener(this); 
mEtVerifyCode.addTextChangedListener(this); 
} 
@Override 
public void doNext() { 
putAsyncTask(new AsyncTask<Void, Void, Boolean>() { 
@Override 
protected void onPreExecute() { 
super.onPreExecute(); 
showLoadingDialog(" 正 在 验证 ,请 稍 后 .."); 


} 
@Override 
protected Boolean doInBackground(Void... params) { 


try { 
Thread.sleep(2000); 


if (DEFAULT_VALIDATE_CODE.equals(mVerifyCode)) { 


return true; 


j 


} catch (InterruptedException e) { 
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return false; 
j 
@Override 
protected void onPostExecute(Boolean result) { 
super.onPostExecute(result); 
dismissLoadingDialog(); 
if (result) { 
mlsChange = false; 
mOnNextActionListener.next(); 
} else { 
mBaseDialog = BaseDialog.getDialog(mContext, "提示 ", "验证 码 错误 ", 
"确认 ", new DialogInterface.OnClickListener() { 


@Override 
public void onClick(DialogInterface dialog, 
int which) { 
mEtVerifyCode.requestFocus(); 
dialog.dismiss(); 
} 
» 
mBaseDialog.show(); 
} 
} 
Ir 
} 
@Override 
public boolean validate() { 
if (isNull(mEtVerifyCode)) { 
showCustomToast(" 请 输入 验证 码 "); 
mEtVerifyCode.requestFocus(); 
return false; 
} 
mVerifyCode = mEtVerifyCode.getText().toString().trim(); 
return true; 
} 
@Override 


public boolean isChange() { 
return mIsChange; 
} 
@Override 
public void onClick(View v) { 
switch (v.getId()) { 
case R.id.reg verify btn resend: 
handler.sendEmptyMessage(0); 
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break; 

case R.id.reg verify htv nocode: 
showCustomToast(" 抱 歉 ,暂时 不 支持 此 操作 "); 
break; 


j 
@Override 
public void afterTextChanged(Editable s) { 


} 
@Override 


public void beforeTextChanged(CharSequence s, int start, int count, 


int after) { 


} 
@Override 


public void onTextChanged(CharSequence s, int start, int before, int count) { 


mlsChange = true; 
} 
Handler handler = new Handler() { 
@Override 
public void handleMessage(Message msg) { 
super.handleMessage(msg); 
if (mReSendTime > 1) { 
mReSendTime--; 
mBtnResend.setEnabled(false); 


mBtnResend.setText(" & /Z (" + mReSendTime + ")"); 
handler.sendEmptyMessageDelayed(0, 1000); 


} else { 
mReSendTime = 60; 
mBtnResend.setEnabled(true); 
mBtnResend.setText(" 重 RI; 


pa 


17.3.4 ”设置 密码 界面 Mctivity 


开发 仿 陌 陌 交友 系统 


如 果 输 入 的 验证 码 合 法 ， 单 击 “ 下 一 步 ” 按 钮 后 会 跳 转 到 设置 密码 界面 ， 在 界面 上 方 显 
示 两 个 文本 框 供 用 户 分 别 输入 登录 密码 和 确认 密码 ， 在 界面 下 方 显示 “J 


按钮 ， 如 图 17-4 所 示 。 


设置 密码 界面 Activity 的 实现 文件 是 StepSetPassword.java， 功 


一 步 ” 和 “下 一 步 ” 


验证 注册 用 户 输 


入 的 两 个 密码 完全 一 致 ， 并 且 是 6 位 以 上 。 文 件 StepSetPassword.java 的 有 具体 实现 代码 


如 下 。 
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Q 设置 密码 3/6 


设置 账号 密码 


deer 3 下 一 步 


图 17-4 设置 密码 界面 


public class StepSetPassword extends RegisterStep implements TextWatcher { 


private EditText mEtPwd; 

private EditText mEtRePwd; 

private boolean mIsChange = true; 

public StepSetPassword(RegisterActivity activity, View contentRootView) { 
super(activity, contentRootView); 

} 

@Override 

public void initViews() { 
mEtPwd = (EditText) findViewByld(R.id.reg_setpwd_et_pwd); 
mEtRePwd = (EditText) findViewById(R.id.reg setpwd et repwd); 

} 

@Override 

public void initEvents() { 
mEtPwd.addTextChangedListener(this); 
mEtRePwd.addTextChangedListener(this); 

} 

@Override 

public void doNext() { 
mlsChange = false; 
mOnNextActionListener.next(); 
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@Override 
public boolean validate() { 
String pwd = null; 
String rePwd = null; 
if (isNull(mEtPwd)) { 
showCustomToast(" 请 输入 密码 "); 
mEtPwd.requestFocus(); 
return false; 
} else { 
pwd = mEtPwd.getText().toString().trim(); 
if (pwd.length() « 6) { 
showCustomToast(" 密 码 不 能 小 于 6 位 "); 
mEtPwd.requestFocus(); 


return false; 


} 
if (isNull(mEtRePwd)) { 
showCustomToast(" ijj E & a1 A — JA 25 115"); 
mEtRePwd.requestFocus(); 
return false; 
} else { 
rePwd = mEtRePwd.getText().toString().trim(); 
if (!pwd.equals(rePwd)) { 
showCustomToast(" V4 TA BI 25:03 AA — $10"); 
mEtRePwd.requestFocus(); 


return false; 


= 一 


} 

return true; 
j 
@Override 


public boolean isChange() { 
return mIsChange; 
} 
@Override 
public void afterTextChanged(Editable s) { 
} 
@Override 
public void beforeTextChanged(CharSequence s, int start, int count, 
int after) { 
} 
@Override 
public void onTextChanged(CharSequence s, int start, int before, int count) { 
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mlsChange = true; 


17.3.5 ”设置 用 户 名 界面 Activity 

如 果 输 入 的 密码 合法 ， 单 击 “ 下 一 步 ” 按 钮 后 会 跳 转 到 设置 用 户 名 界面 ， 在 界面 上 方 显 
示 一 个 文本 框 供用 户 输 入 用 户 名 ， 显 示 一 个 单 选 按钮 供用 户 选择 性 别 ， 在 界面 下 方 显示 “上 
一 步 ” 和 “下 一 步 ” 按 钮 ， 如 图 17-5 所 示 。 


Q asasan 


填写 真实 姓名 将 便于 朋友 们 找到 你 


选择 性 别 BOX 


图 17-5 设置 用 户 名 界面 


输入 用 户 名 并 


ER 
a 
IS 


设置 用 户 名 界面 Activity 的 实现 文件 是 StepBaselnfo java, DIE 38 ul 
选择 性 别 。 文 件 StepBaselnfo.java 的 具体 实现 代码 如 下 。 


public class StepBaseInfo extends RegisterStep implements TextWatcher, 

OnCheckedChangeListener { 

private EditText mEtName; 

private RadioGroup mRgGender; 

private RadioButton mRbMale; 

private RadioButton mRbFemale; 

private boolean mIsChange = true; 

private boolean mIsGenderAlert; 

private BaseDialog mBaseDialog; 

public StepBaseInfo(RegisterActivity activity, View contentRootView) { 
super(activity, contentRootView); 

j 

@Override 
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public void initViews() { 
mEtName = (EditText) findViewById(R.id.reg baseinfo et name); 
mRgGender = (RadioGroup) findViewById(R.id.reg baseinfo rg gender); 
mRbMale = (RadioButton) findViewBylId(R.id.reg baseinfo rb male); 
mRbFemale = (RadioButton) findViewById(R.id.reg baseinfo rb female); 
} 
@Override 
public void initEvents() { 
mEtName.addTextChangedListener(this); 
mRgGender.setOnCheckedChangeL istener(this); 
} 
@Override 
public void doNext() { 
mOnNextActionListener.next(); 
} 
@Override 
public boolean validate() { 
if (isNull(mEtName)) { 
showCustomToast(" 请 输入 用 户 名 "); 
mEtName.requestFocus(); 


return false; 

} 

if (mRgGender.getCheckedRadioButtonId() < 0) { 
showCustomToast(" 请 选择 性 别 "); 


return false; 
} 
return true; 
} 
@Override 


public boolean isChange() { 
return mIsChange; 
} 
@Override 
public void onCheckedChanged(RadioGroup group, int checkedId) { 
mlsChange = true; 
if (!mIsGenderAlert) { 
mIsGenderA lert = true; 


mBaseDialog = BaseDialog.getDialog(mContext, "提示 ", "注册 成 功 后 性 别 将 不 可 更 改 ", 


"确认 ", new DialogInterface.OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) { 
dialog.dismiss(); 


DE 
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mBaseDialog.show(); 

} 

switch (checkedId) { 

case R.id.reg baseinfo rb male: 
mRbMale.setChecked(true); 
break; 

case R.id.reg baseinfo rb female: 
mRbFemale.setChecked(true); 
break; 


} 
@Override 
public void afterTextChanged(Editable s) { 
} 
@Override 
public void beforeTextChanged(CharSequence s, int start, int count, 
int after) { 
} 
@Override 
public void onTextChanged(CharSequence s, int start, int before, int count) { 


mlsChange = true; 


17.3.6 ”设置 生日 界面 Activity 

如 果 设 置 的 用 户 名 和 性 别 合法 ， 单 击 “ 下 一 步 ” 按 钮 后 会 跳 转 到 设置 生日 界面 ， 在 界面 
上 方 显示 年 、 月 、 日 供用 户 选 择 生 日 ， 在 界面 下 方 显示 “上 一 步 ” 和 “下 一 步 ” 按 钮 ， 如 图 
17-6 所 示 。 


Q essa 5/6 


出 生日 期 ABE 242 
Jan 01 1990 
您 的 出 生日 期 不 会 出 现在 个 人 资料 中 。 年 满 12 岁 方 可 
使 用 陌 陌 。 
I-A 下 一 步 
图 17-6 设置 生日 界面 
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Lt 


D 


人 码 如 下 。 


A 


法 性 ， 系 统 要 求 的 合法 年 龄 范围 
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public class StepBirthday extends RegisterStep implements OnDateChangedListener { 


private HandyTextView mHtvConstellation; 
private HandyTextView mHtvAge; 
private DatePicker mDpBirthday; 
private Calendar mCalendar; 
private Date mMinDate; 
private Date mMaxDate; 
private Date mSelectDate; 
private static final int MAX AGE = 100; 
private static final int MIN AGE = 12; 
public StepBirthday(RegisterActivity activity, View contentRootView) { 
super(activity, contentRootView); 
initData(); 
j 
private void flushBirthday(Calendar calendar) { 
String constellation = TextUtils.getConstellation( 
calendar. get(Calendar. MONTH), 
calendar. get(Calendar. DAY OF MONTH)); 
mSelectDate = calendar.getTime(); 
mHtvConstellation.setText(constellation); 
int age = TextUtils. getAge(calendar.get(Calendar. YEAR), 
calendar. get(Calendar. MONTH), 
calendar. gett Calendar. DAN OF MONTH)); 
mHtvAge.setText(age + ""); 
} 
private void initData() { 
mSelectDate = DateUtils.getDate(" 19900101"); 
Calendar mMinCalendar = Calendar.getInstance(); 
Calendar mMaxCalendar = Calendar.getInstance(); 
mMiunCalendar.set(Calendar. YEAR, mMinCalendar.get(Calendar. YEAR) 
- MIN_AGE); 
mMinDate = mMinCalendar.getTime(); 
mMaxCalendar.set(Calendar. YEAR, mMaxCalendar.get(Calendar. YEAR) 
- MAX_AGE); 
mMaxDate = mMaxCalendar.getTime(); 
mCalendar = Calendar. getInstance(); 
mCalendar.setTime(mSelectDate); 
flushBirthday(mCalendar); 
mDphBirthday.init(mCalendar.get(Calendar. Y EAR), 
mCalendar.get(Calendar. MONTH), 
mCalendar.get(Calendar.DAY OF MONTH), this); 


ML aa 


生日 界面 Activity 的 实现 文件 是 StepBirthdayjava， 功 能 是 验证 用 户 设 : 
在 “12 一 100” 岁 之 间 。 文 件 StepBirthday.java 的 


的 年 龄 的 合 


体 实 现代 
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17.3.7 


@Override 
public void initViews() { 


mHtvConstellation = (HandyTextView) findViewById(R.id.reg birthday htv constellation); 


mHtvAge = (HandyTextView) findViewById(R.id.reg birthday htv age); 
mDpBirthday = (DatePicker) findViewById(R.id.reg birthday dp birthday); 
} 
@Override 
public void initEvents() { 
} 
@Override 
public void doNext() { 
mOnNextActionListener.next(); 
} 
@Override 
public boolean validate() { 
return true; 


@Override 
public boolean isChange() { 
return false; 
j 
@Override 
public void onDateChanged(DatePicker view, int year, int monthOfY ear, 
int dayOfMonth) { 
mCalendar = Calendar. getInstance(); 
mCalendar.set(year, monthOfYear, dayOfMonth); 
if (mCalendar.getTime().after(rmMinDate) 
|| mCalendar.getTime().before(mMaxDate)) { 
mCalendar.setTime(mSelectDate); 
mDpBirthday.init(mCalendar.get(Calendar. YEAR), 
mCalendar.get(Calendar. MONTH), 
mCalendar.get(Calendar.DAY OF MONTH), this); 
} else { 
flushBirthday(mCalendar); 


设置 头像 界面 Mctivity 


pal 


如 图 17-7 所 示 。 
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如 果 设 置 的 年 龄 合法 ， 单 击 “ 下 一 步 ” 按 钮 后 会 跳 转 到 设置 头像 界面 ， 在 界面 上 方 显示 


选择 图 片 按钮 和 拍照 按钮 供用 户 快 速 设置 头像 ， 在 界面 下 方 显示 “上 一 步 ”和 “ 注 } 


W^ pL 
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© 设置 头像 6/6 


填写 推荐 人 陌 陌 号 ， 送 特殊 聊天 表情 


O amar 


© sens 


上 传真 实 的 头像 ， 拉 近 真 实 的 距 


3á 


附近 的 陌 陌 
上 一 步 注 册 


图 17-7 设置 头像 界面 


设置 头像 界面 Activity 的 实现 文件 是 StepPhoto.java， 功 能 是 验证 用 户 } 
文件 StepPhoto.java 的 具体 实现 代码 如 下 。 


public class StepPhoto extends RegisterStep implements OnClickListener { 


private HandyTextView mHtvRecommendation; 

private ImageView mlvUserPhoto; 

private LinearLayout mLayoutSelectPhoto; 

private LinearLayout mLayoutTakePicture; 

private LinearLayout mLayoutA vatars; 

private View[] mMemberBlocks; 

private String[] mAvatars = new String[] { "welcome 0", "welcome 1", 
"welcome 2", "welcome 3", "welcome 4", "welcome 5"; 

private String[] mDistances = new String[] { "0.84km", "1.02km", "1.34km", 
"1.88km", "2.50km", "2.78km" }; 

private String mTakePicturePath; 

private Bitmap mUserPhoto; 

private EditTextDialog mEditTextDialog; 

public StepPhoto(RegisterActivity activity, View contentRootView) { 

super(activity, contentRootView); 


initA vatarsItem(); 

j 

private void initAvatarsItem() { 
initMemberBlocks(); 


for (int i = 0; i < mMemberBlocks.length; i++) { 
((ImageView) mMemberBlocks[i] 
.findViewById(R.id.welcome item iv avatar)) 


.setimageBitmap(getBaseA pplication().getAvatar(mAvvatars[i])); 
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((HandyTextView) mMemberBlocks[i] 
.findViewById(R.id.welcome item htv distance)) 
.setText(mDistances[1]); 


j 


private void initMemberBlocks() { 

mMemberBlocks = new View[6]; 
mMemberBlocks[0] = findViewByld(R.id.reg_ photo include member avatar block0); 
mMemberBlocks[1] = findViewById(R.id.reg photo include member avatar block1); 
mMemberBlocks[2] = findViewById(R.id.reg photo include member avatar block2); 
m [ 
m [ 


MemberBlocks[3] = findViewById(R.id.reg photo include member avatar block3); 
MemberBlocks[4] = findViewById(R.id.reg photo include member avatar block4); 
mMemberBlocks[5] = findViewById(R.id.reg photo include member avatar block5); 
int margin = (int) TypedValue.applyDimension( 

TypedValue. COMPLEX UNIT DIP, 4, mContext.getResources() 

.getDisplayMetrics()); 

int widthAndHeight = (getScreenWidth() - margin * 12) / 6; 
for (int i = 0; i < mMemberBlocks.length; i++) { 
ViewGroup.LayoutParams params = mMemberBlocks[i].find ViewByld( 


R.id.welcome item iv avatar).getLayoutParams(); 
params.width — widthAndHeight; 
params.height — widthAndHeight; 
mMemberBlocks[i].find ViewById(R.id.welcome item iv avatar) 


.setLayoutParams(params); 


j 


mLayoutA vatars.invalidate(); 
j 
public void setUserPhoto(Bitmap bitmap) { 
if (bitmap != null) { 
mUserPhoto = bitmap; 
mlvUserPhoto.setlImageBitmap(mUserPhoto); 
return; 
j 
showCustomToast(" 未 获取 到 图 片 "); 
mUserPhoto = null; 


mlvUserPhoto.setImageResource(R.drawable.ic common def header); 

} 

public String getTakePicturePath() { 
return mTakePicturePath; 

j 

@Override 

public void initViews() { 
mHtvRecommendation = (Handy TextView) findViewByld(R.id.reg_photo_htv recommendation); 
mlvUserPhoto = (Image View) findViewByld(R.id.reg photo iv userphoto); 
mLayoutSelectPhoto = (LinearLayout) findViewById(R.id.reg photo layout selectphoto); 
mLayoutTakePicture = (LinearLayout) find ViewBylId(R.id.reg photo layout takepicture); 
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mLayoutAvatars = (LinearLayout) findViewById(R.id.reg photo layout avatars); 


} 

@Override 

public void initEvents() { 
mHtvRecommendation.setOnClickListener(this); 
mLayoutSelectPhoto.setOnClickListener(this); 
mLayoutTakePicture.setOnClickListener(this); 

} 

@Override 

public boolean validate() { 
if (mUserPhoto == null) { 

showCustomToast(" 请 添加 头像 "); 


return false; 
j 
return true; 
j 
@Override 


public void doNext() { 
putAsyncTask(new AsyncTask<Void, Void, Boolean>() { 
@Override 
protected void onPreExecute() { 
super.onPreExecute(); 
showLoadingDialog("i#4H Ja, IE TET AZ...."); 


} 
@Override 
protected Boolean doInBackground(Void... params) { 
try { 
Thread.sleep(2000); 
return true; 
} catch (InterruptedException e) { 
} 
return false; 
} 
@Override 


protected void onPostExecute(Boolean result) { 
super.onPostExecute(result); 
dismissLoadingDialog(); 
if (result) { 
mActivity.finish(); 


Ir 
} 
@Override 
public boolean isChange() { 
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return false; 
} 
@Override 
public void onClick(View v) { 
switch (v.getId()) { 
case R.id.reg photo htv recommendation: 
mEditTextDialog = new EditTextDialog(mContext); 
mEditTextDialog.setTitle(" CG MESS A"); 
mEditTextDialog.setButton(" D lj", 
new DialogInterface.OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) { 
mEditTextDialog.cancel(); 


} 
1, "确认 ", new DialogInterface.OnClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which) { 
String text = mEditTextDialog.getText(); 
if (text == null) { 
mEditTextDialog.requestFocus(); 
showCustomToast(" 请 输入 推荐 人 号 码 "); 
} else { 
mEditTextDialog.dismiss(); 
showCustomToast(" ft 4 A. f 


(Ede 


E 荐 人 号 码 为 :" + text); 


Di 
mEditTextDialog.show(); 
break; 
case R.id.reg photo layout selectphoto: 
PhotoUtils.selectPhoto(mActivity); 
break; 
case R.id.reg photo layout takepicture: 
mTakePicturePath = PhotoUtils.takePicture(mActivity); 
break; 


j 


设置 头像 完毕 后 ， 单 击 “ 


主 册 ”按钮 完成 注册 。 


pe» 


174 “实现 系统 主 界 面 


当 用 户 输 入 合法 的 注册 信息 登录 陌 陌 后 ， 会 首先 显示 系统 主 界面 ， 如 几 17-8 所 示 。 
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Q Hi ^^ 


EKAA Be) 
13 0.08km | 53 分 钟 前 


谁 知道 蒙 衣 草 的 花语 是 什么 啊 ? 


| 小 耳 灯 LES 


E 0.11km | 35 分 钟 前 


LES 
ga 
LAES 0.13km | 13 分 钟 前 
以 前 爱 他 ,现在 爱 它 
榴 前 听 雨 GR 


| 227 | 


0.16km | 30 分 钟 前 


图 17-8 系统 主 界面 


在 本 节 的 内 容 中 ， 将 详细 讲解 系统 主 界面 的 基体 实现 过 程 。 


17.4.1 


主 界面 布局 


系统 主 界面 的 布局 文 伯 


分 割 成 $ 个 部 分 。 文 件 activity maintabs.xml 的 具体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<TabHost xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="(@android:id/tabhost" 
android:layout width-"fill parent" 
android:layout height-"fill parent" > 
<LinearLayout 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:background="#ffffffft" > 
<RelativeLayout 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" > 
<FrameLayout 
android:id="@android:id/tabcontent" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layout_above="@android:id/tabs" 
android:background-" (g)color/background normal" /> 


F 是 activity maintabs.xml, DEE KI TabWidget 控件 


T 
EH 


各 屏幕 界面 
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17.4.2 


<TabWidget 
android:id="@android:id/tabs" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:layout_alignParentBottom="true" 
android: divider="@null" /> 
</RelativeLayout> 
</LinearLayout> 
</TabHost> 


实现 主 界面 Activity 


EFM Activity 的 实现 文件 是 MainTabActivity.java， 功 能 是 通 
示 TabWidget 控件 中 的 内 容 ， 默 认 设置 为 显示 “附近 的 人 ” 文件 MainTabActivityjava HJH 


实现 代码 如 下 。 
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public class MainTabActivity extends TabActivity { 

private TabHost mTabHost; 

@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity maintabs); 
initViews(); 
initTabs(); 

} 

private void initViews() { 
mTabHost = getTabHost(); 

} 


private void initTabs() { 


过 函数 initTabs() 初 始 化 显 


LayoutInflater inflater = LayoutInflater.from(MainTabActivity.this); 


View nearbyView = inflater.inflate( 


R.layout.common_bottombar_tab_nearby, null); 
TabHost.TabSpec nearbyTabSpec = mTabHost.newTabSpec( 

NearByActivity.class.getName()).setIndicator(nearby View); 
nearbyTabSpec.setContent(new Intent(MainTabActivity.this, 


NearByActivity.class)); 
mTabHost.addTab(nearbyTabSpec); 
View nearbyFeedsView = inflater.inflate( 


R.layout.common bottombar tab site, null); 


TabHost.TabSpec nearbyFeedsTabSpec = mTabHost.newTabSpec( 
NearByFeedsActivity.class.getName()).setIndicator( 


nearbyFeedsView); 


nearbyFeedsTabSpec.setContent(new Intent(MainTabA ctivity.this, 


NearByFeedsActivity.class)); 
mTabHost.addTab(nearbyFeedsTabSpec); 


本 


第 17 章 开发 仿 陌 陌 交 友 系 统 


View sessionListView = inflater.inflate( 
R.layout.common_bottombar_tab_chat, null); 
TabHost.TabSpec sessionListTabSpec = mTabHost.newTabSpec( 
SessionListActivity.class.getName()).setIndicator( 
sessionListView); 
sessionListTabSpec.setContent(new Intent(MainTabActivity.this, 
SessionListActivity.class)); 
mTabHost.addTab(sessionListTabSpec); 
View contactView = inflater.inflate( 
R.layout.common_bottombar_tab_friend, null); 
TabHost.TabSpec contactTabSpec = mTabHost.newTabSpec( 
ContactTabsActivity.class.getName()).setIndicator(contactView); 
contactTabSpec.setContent(new Intent(MainTabActivity.this, 
ContactTabsActivity.class)); 
mTabHost.addTab(contactTabSpec); 
View userSetting View = inflater.inflate( 
R.layout.common bottombar tab profile, null); 
TabHost.TabSpec userSettingTabSpec = mTabHost.newTabSpec( 
UserSettingActivity.class.getName()).setIndicator( 
userSettingView); 
userSettingTabSpec.setContent(new Intent(MainTabActivity.this, 
UserSettingActivity.class)); 
mTabHost.addTab(userSettingTabSpec); 


j 


17.4.3 ”实现 “附近 的 人 ”界面 


在 系统 主 界面 中 ， 中 间 大 部 分 内 容 显示 的 是 系统 “附近 的 人 ”信息 ， 此 功能 的 实现 布局 
文件 是 common bottombar tab nearbyxml， 有 具体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"Odip" 
android:layout_height="40dip" 
android:layout_weight="1" 
android:background-"(g)drawable/bg tb item center" 
android:paddingBottom="2dip" > 
<com.immomo.momo.android.view. HandyTextView 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_centerInParent="true" 
android:drawableTop-"(g)drawable/ic tab nearby" 


android:gravity-"center horizontal" 
android:text-" [f ir" 
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android:textColor="(@color/maintab_text_color" 
android:textSize="11sp" 
android:shadowDx="0.0" 
android:shadowDy="-1.0" 
android:shadowRadius="1.0"/> 


</RelativeLayout> 


“附近 的 人 ”界面 Activity 的 实现 文件 是 NearByActivity.java， 功能 是 在 顶部 显示 “附近 ”、 
“和 群 组 ”和 “个 人 ”选项 卡 ， 并 监听 用 户 单 击 屏幕 事件 ， 根 据 用 户 操作 执行 对 应 的 事件 处 理 函 
数 。 例 如 单 击 搜索 图 标 国 可 以 根据 关键 字 快 速 检索 附近 的 人 。 文 件 NearByActivity.java 的 其 
体 实 现代 码 如 下 。 


public class NearByActivity extends TabltemActivity { 

private HeaderLayout mHeaderLayout; 

private HeaderSpinner mHeaderSpinner; 

private NearByPeopleFragment mPeopleFragment; 

private NearByGroupFragment mGroupFragment; 

private NearByPopup Window mPopupWindow; 

@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity nearby); 


initPopupWindow(); 
initViews(); 
initEvents(); 
init(); 

j 

@Override 


protected void initViews() { 
mHeaderLayout = (HeaderLayout) findViewByld(R.id.nearby_header); 
mHeaderLayout.initSearch(new OnSearchClickListener()); 
mHeaderSpinner = mHeaderLayout.setTitleNearBy(" [f 3/7", 
new OnSpinnerClickListener(), "附近 群 组 "， 
R.drawable.ic_topbar_search, 
new OnMiddleImageButtonClickListener(), "个 人 ", "和 群 组 "， 
new OnSwitcherButtonClickListener()); 
mHeaderLayout.init(HeaderStyle. TITLE NEARBY PEOPLE); 


j 

@Override 

protected void initEvents() { 

} 

@Override 

protected void init() { 
mPeopleFragment = new NearByPeopleFragment(mA pplication, this, this); 
mGroupFragment = new NearByGroupFragment(mApplication, this, this); 
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FragmentTransaction ft = getSupportFragmentManager().beginTransaction(); 
ft.replace(R.id.nearby layout content, mPeopleFragment).commit(); 
} 
private void initPopupWindow() { 
mPopup Window = new NearByPopupWindow(this); 
mPopupWindow.setOnSubmitClickListener(new onSubmitClickListener() { 
@Override 
public void onClick() { 
mPeopleFragment.onManualRefresh(); 


= 一 


Ir 

mPopupWindow.setOnDismissListener(new OnDismissListener() { 
@Override 
public void onDismiss() { 


mHeaderSpinner.initSpinnerState(false); 


» 
j 
public class OnSpinnerClickListener implements onSpinnerClickListener { 
@Override 
public void onClick(boolean isSelect) { 
if (isSelect) { 
mPopupWindow 
.showViewTopCenter(findViewById(R.id.nearby layout root)); 
} else { 
mPopupWindow.dismiss(); 


j 


public class OnSearchClickListener implements onSearchListener { 
@Override 
public void onSearch(EditText et) { 
String s = et.getText().toString().trim(); 
if (TextUtils.isEmpty(s)) { 
showCustomToast(" 请 输入 搜索 关键 字 "); 
et.requestFocus(); 
} else { 
((InputMethodManager) getSystemService(INPUT METHOD SERVICE)) 
.hideSoftInputFromWindow(NearBy A ctivity.this 
.getCurrentFocus().getWindowToken(), 
InputMethodManager.HIDE NOT ALWAYS); 
putAsyncTask(new AsyncTask<Void, Void, Boolean>() { 
@Override 
protected void onPreExecute() { 
super.onPreExecute(); 
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mHeaderLayout.changeSearchState(SearchState. SEARCH); 
} 
@Override 
protected Boolean doInBackground(Void... params) { 
try { 
Thread.sleep(2000); 
} catch (InterruptedException e) { 
e.printStackTrace(); 


j 


return false; 

j 

@Override 

protected void onPostExecute(Boolean result) { 
super.onPostExecute(result); 
mHeaderLayout.changeSearchState(SearchS tate. INPUT); 
showCustomToast(" 未 找到 搜索 的 群 "); 


} 


public class OnMiddleImageButtonClickListener implements 
onMiddleImageButtonClickListener { 
@Override 
public void onClick() { 
mHeaderLayout.showSearch(); 


j 


public class OnSwitcherButtonClickListener implements 
onSwitcherButtonClickListener { 
@Override 
public void onClick(SwitcherButtonState state) { 
FragmentTransaction ft = getSupportFragmentManager() 
.beginTransaction(); 
ft.setCustomAnimations(R.anim.fragment fadein, 
R.anim.fragment fadeout); 
switch (state) { 
case LEFT: 
mHeaderLayout.init(HeaderStyle. TITLE NEARBY PEOPLE); 
ft.replace(R.id.nearby layout content, mPeopleFragment) 
.commit(); 
break; 


case RIGHT: 
mHeaderLayout.init(HeaderStyle. TITLE NEARBY GROUP); 
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ft.replace(R.id.nearby layout content, mGroupFragment).commit(); 
break; 


} 
@Override 
public void onBackPressed() { 
if (mHeaderLayout.searchIsShowing()) { 
clearAsyncTask(); 
mHeaderLayout.dismissSearch(); 
mHeaderLayout.clearSearch(); 
mHeaderLayout.changeSearchState(SearchState. INPUT); 
} else { 
finish(); 


17.44 实现 “附近 的 群 组 ”界面 


当 在 顶部 EEEE 国 单 击 “ 群 组 ”选项 卡 后 ， 会 在 系统 主 界面 中 间 显 示 系 统 “ 附 近 的 群 组 ” 
信息 ， 此 功能 的 实现 布局 文件 是 fragment nearbygroup.xml， 有 具体 实现 代码 如 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<FrameLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 
«com.immomo.momo.android.view.MoMoRefreshExpandableList 
android:id-"(g)Hd/nearby group mmrelv list" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:cacheColorHint-" 
android:divider="(@null" 


android:fadingEdge="none" 


@color/transparent" 


android:listSelector="(@drawable/list_selector_transition" > 
</com.immomo.momo.android.view.MoMoRefreshExpandableList> 
<LinearLayout 
android:id-"(g)Hd/nearby group layout cover" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:clickable="true" > 
<include 
layout="@layout/include_nearby_group_header" 
android:visibility="invisible" /> 
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</LinearLayout> 
</FrameLayout> 


“附近 的 群 组 ”界面 Activity 的 实现 文件 是 NearByGroupFragmentjava， 功 能 是 在 系统 主 
界面 中 间 加 载 显 示 附 近 的 群 组 信息 ， 并 通过 onRefresh0 函 数 进行 刷新 以 及 显示 最 新 的 群 主 。 
文件 NearByGroupFragment.java 的 具体 实现 代码 如 下 。 


public class NearByGroupFragment extends BaseFragment implements 

OnClickListener, OnItemClickListener, OnRefreshListener, 
OnCancelListener { 

private LinearLayout mLayoutCover; 

private MoMoRefreshExpandableList mMmrelvList; 

private NearByGroupA dapter mA dapter; 

public NearByGroupFragment() { 
super(); 

} 

public NearByGroupFragment(BaseA pplication application, Activity activity, 

Context context) { 

super(application, activity, context); 

} 

@Override 

public View onCreateView(LayoutInflater inflater, ViewGroup container, 

Bundle savedInstanceState) { 
mView = inflater.inflate(R.layout.fragment nearbygroup, container, 
false); 

return super.onCreateView(inflater, container, savedInstanceState); 

} 

@Override 

protected void initViews() { 
mLayoutCover = (LinearLayout) findViewBylId(R.id.nearby group layout cover); 
mMmrelvList = (MoMoRefreshExpandableList) findViewById(R.id.nearby group mmrelv list); 

} 

@Override 

protected void initEvents() { 
mLayoutCover.setOnClickListener(this); 
mMmrelvList.setOnItemClickListener(this); 
mMmrelvList.setOnRefreshListener(this); 
mMmrelvList.setOnCancelListener(this); 

} 

@Override 

protected void init() { 
getGroups(); 

} 

private void getGroups() { 
if (mApplication.mNearByGroups.isEmpty()) { 
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putAsyncTask(new AsyncTask<Void, Void, Boolean>() { 
@Override 
protected void onPreExecute() { 
super.onPreExecute(); 
showLoadingDialog(" 正 在 加 载 ,请 稍 后 ..…"); 


j 
@Override 
protected Boolean doInBackground( Void... params) { 
return JsonResolveUtils.resolveNearbyGroup(mA pplication); 
j 
@Override 
protected void onPostExecute(Boolean result) { 
super.onPostExecute(result); 
dismissLoadingDialog(); 
if (!result) { 
showCustomToast(" 数 据 加 载 失败 .."); 
} else { 
mAdapter = new NearByGroupA dapter(mApplication, 
mContext, mApplication.mNearByGroups); 
mMmrelvList.setAdapter(mA dapter); 
mMnrrelvList.setPinnedHeaderView(mActivity 
.getLayoutInflater().inflate( 
R.layout.include_nearby_group_header, 
mMmrelvList, false)); 


» 
} else { 

mAdapter = new NearByGroupAdapter(mA pplication, mContext, 
mApplication.mNearByGroups); 

mMmrelvList.setAdapter(mA dapter); 

mMmrelvList.setPinnedHeaderView(mActivity.getLayoutInflater() 
Anflate(R.layout.include nearby group header, mMmrelvList, 

false)); 


} 
@Override 
public void onRefresh() { 
putAsyncTask(new AsyncTask<Void, Void, Boolean>() { 
@Override 
protected Boolean doInBackground(Void... params) { 
try { 
Thread.sleep(2000); 
} catch (InterruptedException e) { 


j 
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return null; 

} 

@Override 

protected void onPostExecute(Boolean result) { 
super.onPostExecute(result); 
mMmrelvList.onRefreshComplete(); 


Di 

} 

@Override 

public void onCancel() { 
clearAsyncTask(); 
mMmrelvList.onRefreshComplete(); 

} 

@Override 


public void onltemClick(AdapterView<?> arg0, View argl, int arg2, long arg3) { 


} 
@Override 


public void onClick(View v) { 
if (mMmrelvList.ismHeaderViewVisible()) { 


mA dapter.onPinnedHeaderClick(mMmrelvList. getFirstItemPosition()); 


} else { 
mAdapter.onPinnedHeaderClick(1); 


j 


到 此 为 止 ， 本 章 仿 陌 陌 系统 的 主要 内 容 介绍 完毕 。 篇 幅 所 限 ， 本 书 没 有 讲解 找 回 密码 、 
H 


聊天 交流 、 设 置 、 留 言 板 等 信息 。 有 关 这 方面 的 具体 内 容 ， 请 读者 参考 本 书 网 络 资源 中 的 源 


代码 。 
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本 书 全 部 内 容 分 为 四 篇 ， 共 计 17 章 ， 循 序 渐进 地 讲解 了 
Android 网 络 开发 方面 的 知识 。 本 书 从 搭建 开发 环境 和 核心 杠 
架 分 析 讲 起 ， 依 次 讲解 了 Android 系统 概述 ，Android 网 络 开 
发 基础 ，Java 中 的 网 络 通信 基础 ， 下 载 、 上 传 数 据 ，Socket 数 
据 通信 ， 处 理 XML SS, WebKit 浏览 网 页 ， 开 发 移动 网 页 ， 开 
发 蓝牙 应 用 程序 ， 开 发 Wi-Fi 应 用 程序 ，NFC 近 场 通信 技术 详 
解 ， 开 发 电子 邮件 应 用 程序 ，Android 典型 网 络 应 用 实践 ， 开 
发 移动 微 博 应 用 程序 ， 开 发 Web 版 的 电话 本 管理 系统 ， 开 发 移 
动 微 信 系统 ， 开 发 仿 陌 陌 交 友 系 统 等 高 级 知识 。 本 书 几 乎 涵盖 
了 Android 网 络 开发 中 的 所 有 主要 内 容 ， 并 且 全 书 内 容 言 简 意 
TK, 讲解 方法 通俗 易 懂 、 详 细 , 不 但 适合 应 用 开发 高 手 们 的 学 习 ， 
也 特别 适合 初学 者 的 系统 学 习 。 

本 书 适合 Android 初学 者 、Android 爱好 者 、Android MA 
开发 人 员 和 移动 浏览 器 开发 人 员 ， 也 可 以 作为 相关 培训 学 校 和 
大 专 院 校 相关 专业 的 教学 用 书 。 
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